EngCreateEngine

Creates an engine instance.

Syntax

PULSE_STATUS EngCreateEngine(
 [out] PPS_ENGINE *ppEngine
);

Parameters

PPS_ENGINE *ppEngine

A pointer to the resulting PPS_ENGINE structure. The PS_ENGINE structure is opaque to the user. Treat it as a handle for other engine 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
ppEngine argument is NULL.

Remarks

Use the EngDestroyEngine function to destroy the engine created by this function.

The engine is stopped when created. Assign a transport using the EngAssignTransport function before starting it.