Edit

IApoAuxiliaryInputRT::AcceptInput method (audioenginebaseapo.h)

  • Article

Provides input to the APO on one of its auxiliary inputs.

Syntax

void AcceptInput(
  DWORD                         dwInputId,
  const APO_CONNECTION_PROPERTY *pInputConnection
);

Parameters

dwInputId

Identifier for the input. This is a unique identifier generated by the system. The APO can use this identifier to differentiate between multiple auxiliary inputs.

pInputConnection

The input connection property structure.

Return value

None

Remarks

This method may be called from a real-time processing thread. The implementation of this method does not and should not block, touch paged memory, or call any blocking system routines.

The cadence of the input endpoint may not match the cadence of the render endpoint, and therefore the cadence with which input is provided to the auxiliary input may not match the cadence with which IAudioProcessingObjectRT::APOProcess is called on the primary input. The APO must implement appropriate non-blocking buffering to ensure that this call does not block.

The APO_CONNECTION_PROPERTY_V2 includes a timestamp that can be used to synchronize the primary and secondary streams. If the u32Signature field of the APO_CONNECTION_PROPERTY structure passed into IAudioProcessingObjectRT::APOProcess is equal to APO_CONNECTION_PROPERTY_V2_SIGNATURE, the structure can be safely typecast to a APO_CONNECTION_PROPERTY_V2.

Requirements

Requirement Value
Minimum supported client Windows 10 Build 20348
Header audioenginebaseapo.h

See also

IAudioProcessingObjectRT::APOProcess APO_CONNECTION_PROPERTY_V2