PsRequestCreate

Creates a Pulse API request instance.

Syntax

PULSE_STATUS PsRequestCreate(
 [in] PPS_ENGINE pEngine,
 [out] PPS_REQUEST *ppRequest
);

Parameters

PPS_ENGINE pEngine

An opaque handle to an engine created by the EngCreateEngine function.

PPS_REQUEST *ppRequest

A pointer to the resulting PPS_REQUEST handle. The PS_REQUEST structure is opaque to the user. Treat it as a handle for other Pulse request API functions.

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_INSUFFICIENT_RESOURCES
0xC0000002		 One of the memory allocations failed during initialization.
PULSE_STATUS_INVALID_PARAMETER
0xC0000010		 Might happen if:
  • The pEngine argument is NULL.
  • The ppRequest argument is NULL.
    		•

    Remarks

    PS_REQUEST is a handle to a Pulse API request placeholder. It may be used for asynchronous Pulse API request submission to the debuggee. See the PsRequestSubmit function.

    A single request can handle a single Pulse API function.