TransportSetRawDataCallback

Assigns a raw data callback to a given transport.

Syntax

PULSE_STATUS TransportSetRawDataCallback(
 [in] PPS_TRANSPORT pTransport,
 [in] lpfnRawDataCallback RawDataCallback,
 [in] uintptr_t Context
);

Parameters

PPS_TRANSPORT pTransport

An opaque handle to a transport created by the TransportCreate function.

lpfnRawDataCallback RawDataCallback

A callback function that will be called every time the transport receives non-debug-protocol data. See the defintion of lpfnRawDataCallback for its arguments.

uintptr_t Context

A user-defined context for the lpfnRawDataCallback function. This will be passed as the "Context" parameter in the callback.

Return value

If the function succeeds, the return value is PULSE_STATUS_SUCCESS.

If it fails, it returns one of the PULSE_STATUS values. Possible return codes include, but are not limited to, the following:

PULSE_STATUS_INVALID_PARAMETER
0xC0000010
The pTransport argument is NULL.

Remarks

This callback is executed in a dedicated thread. You cannot call any other PulseSDK function within it. The engine will not continue working until the callback function returns.

It can be set at any moment during the transport's lifetime.

It can be set to NULL so that it won't trigger any callbacks on non-debug-protocol data.