IAudioProcessingObjectPreferredFormatSupport::GetPreferredInputFormat-Methode (audioengineextensionapo.h)

Rückruffunktion, mit der APOs ein bevorzugtes Eingabeformat für das bereitgestellte Ausgabeformat angeben können.

Syntax

HRESULT GetPreferredInputFormat(
  [in]  IAudioMediaType *outputFormat,
  [out] IAudioMediaType **preferredFormat
);

Parameter

[in] outputFormat

Ein IAudioMediaType , der das Ausgabeformat darstellt, das dem Rückruf zugeordnet ist.

[out] preferredFormat

Ein IAudioMediaType , der das bevorzugte Eingabeformat für den APO darstellt.

Rückgabewert

Ein HRESULT.

Hinweise

Diese API ermöglicht Szenarien wie einen Kopfhöreranbieter, der virtuellen Surround-Sound bereitstellt. Der APO kann den Empfang einer 7-1-Eingabe anfordern, obwohl der Endpunkt in Stereo gerendert wird. APOs können verschiedene bevorzugte Formate für unterschiedliche Ausgabeformate angeben. Beispielsweise kann eine App 7.1-Eingabe anfordern, wenn der m-Streamtyp Medien ist, aber eine Stereoeingabe anfordern, wenn der Streamtyp Kommunikation ist.

Anforderungen