MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID属性

オーディオエンドポイントデバイスの識別子を指定します。

データ型

ワイド文字列の文字列

この属性を使用して、オーディオレンダラーを構成できます。使用は、オーディオレンダラーを作成するために呼び出す関数によって異なります。

MFCreateAudioRenderer: pAudioAttributes パラメーターで指定された IMFAttributes インターフェイスポインターを使用して、この属性を設定します。
MFCreateAudioRendererActivate: ppActivate パラメーターで取得した IMFActivate インターフェイスポインターを使用して、この属性を設定します。 IMFActivate::ActivateObject を呼び出す前に、属性を設定します。

オーディオエンドポイントデバイスは、ヘッドホンやスピーカーなどのオーディオデータパスの一方の端にあるハードウェアデバイスです。オーディオエンドポイント識別子を取得するには、次のコアオーディオ API を使用します。

詳細については、 Core Audio API のドキュメントを参照してください。この属性が設定されていない場合、オーディオレンダラーは既定のエンドポイントデバイスを使用します。

この属性が設定されている場合は、 MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE 属性を設定しないでください。両方の属性が設定されている場合、オーディオレンダラーの作成時にエラーが発生します。

この属性の GUID 定数は、mfuuid.lib からエクスポートされます。