IP_TaskFindID

Cogent API and Utilities: Version 4.1
Prev |  | Next

# `IP_TaskFindID`

`IP_TaskFindID` -- finds a task by its node, process, and channel IDs.

## Syntax

``IP_Task* `IP_TaskFindID``(int nid, int pid, int chid);`

## Arguments

`nid`

  The node ID of the task to be found.

`pid`

  The process ID of the task to be found.

`chid`

  The channel ID of the task to be found.

## Returns

A pointer to a cached `IP_Task` whose `nid`, `pid` and `chid` exactly match the requested values, or `NULL` if there is no match.

## Description

This function looks up a task in the current process's task cache by matching the node, process ID and channel ID of the target task. Channel ID is only relevant in QNX 6.

## See Also

Task Structure Caching, `IP_TaskFindName`

Prev | Home | Next
`IP_TaskDestroy` | Up | `IP_TaskFindName`

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.