AcpHalCreate

Creates an instance of the ACP interface.

Syntax

HRESULT AcpHalCreate(
         IAcpHal **acp
)  

Parameters

acp
Type: IAcpHal **

[out] ACP interface instance.

Return value

Type: HRESULT 

If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.

Return codes
Return code Description
E_OUTOFMEMORY There has been a memory allocation failure.

Remarks

This call creates an ACP client. An ACP client can process one flowgraph at a time. Multiple clients need to be created if multiple flowgraphs are to be processed simultaneously. Refer to the ACP Overview for more details on using multiple flowgraphs.

Any contexts that are to be used with an ACP client must be allocated with AcpHalAllocateShapeContexts prior to calling AcpHalCreate.

Requirements

Header: Declared in acphal.h.

Library: Use acphal.lib.