NPA_Return_EventBlocks

Returns a pointer to a linked list of event blocks to be returned.

Thread Context:Blocking

Syntax

    LONG NPA_Return_EventBlocks (
       LONG                     npaHandle,
       struct EventBlockDef *eventBlock
    );

Parameters

npaHandle
(IN) The CDM's or HAM's handle for using the NPA APIs. Its value was assigned during NPA_Register_CDM_Module or NPA_Register_HAM_Module, respectively.
eventBlock
(IN) Points to a linked list of event blocks to be returned. See EventBlockStruct.

Return Values

The following table lists return values and descriptions.

0

SUCCESS

The list of event blocks was successfully returned.

-1

INVALID_PARAMETER

The specified event block is either in use or not valid or npaHandle is invalid.

Remarks

NPA_Return_EventBlocks is used to return an event block that was allocated using NPA_Get_EventBlocks. The module must return all blocks before unloading. The event blocks are linked together using the link field. The link field in the structure on the end of the list must be set to NULL.