CDI_Execute_HACB

Initiates the execution of a SuperHACB request.

Thread Context:Non-Blocking

Syntax

    LONG CDI_Execute_HACB (
       LONG   msgPutHandle,
       LONG   hacbPutHandle,
       LONG   (*CDM_Callback)()
       );

Parameters

msgPutHandle
(IN) Handle to the CDM message (CDMMessageStruct) from which the SuperHACB was built. The value of this parameter is obtained from the msgPutHandle field of the CDMMessageStruct.
hacbPutHandle
(IN) Handle to the HACB request being executed. The value of this parameter is obtained from the hacbPutHandle field of the original SuperHACB's member HACB.
CDM_Callback
(IN) Address of the CDM function to be called when the HACB request completes. A callback function must be specified for each issued request.

Return Values

The following table lists return values and descriptions.

zero

Successful

nonzero

Unsuccessful

Remarks

CDI_Execute_HACB is used by a CDM to initiate the execution of a HACB request by routing a HACB to the HAM supporting the target device. Most HACB requests should be executed using this function.

WARNING:This call is valid only in the context of CDM_Execute_CDMMessage. If a message has been queued and a thread is spawned, use either CDI_Blocking_Execute_HACB or CDI_Non_Blocking_Execute_HACB instead, depending on the context of the thread to be spawned.