SetShapeAllocMixBufferCommand

Allocates a virtual mix buffer. All mix buffers are single channel (mono) and must be allocated before use. Although there are a total of 128 physical mix buffers, there are 8192 virtual mix buffers available. Physical mix buffers can be reused whereas virtual mix buffers cannot be reused.

Syntax

HRESULT SetShapeAllocMixBufferCommand(
         SHAPE_FLOWGRAPH_COMMAND *command,
         UINT32 virtualId,
         UINT32 numIn,
         UINT32 numOut,
         SHAPE_MIXBUFFER_ATTENUATION attenuation
)  

Parameters

command
Type: SHAPE_FLOWGRAPH_COMMAND *

[in, out] The SHAPE_FLOWGRAPH_COMMAND command to initialize.

virtualId
Type: UINT32 

Virtual ID of the mix buffer, from 0 to 8191 inclusive. All allocated mix buffers must have a unique virtual ID.

numIn
Type: UINT32 

Number of inputs to the mix buffer. This value specifies the number of SHAPE blocks that will output to this mix buffer.

numOut
Type: UINT32 

Number of outputs from the mix buffer This value specifies the number of SHAPE blocks that will read from this mix buffer.

attenuation
Type: SHAPE_MIXBUFFER_ATTENUATION 

One member of the SHAPE_MIXBUFFER_ATTENUATION enumeration. This value specifies the dB attenuation applied to all inputs to this mix buffer.

Return value

Type: HRESULT 

HRESULT success (S_OK) or failure (E_INVALIDARG) code.

Requirements

Header: Declared in shapeflowgraph.h.

Library: Use acphal.lib.