MFCreateAudioRendererActivate 関数 (mfidl.h)

ストリーミング オーディオ レンダラーのアクティブ化オブジェクトを作成します。

構文

HRESULT MFCreateAudioRendererActivate(
  [out] IMFActivate **ppActivate
);

パラメーター

[out] ppActivate

IMFActivate インターフェイスへのポインターを受け取ります。 このインターフェイスを使用して、オーディオ レンダラーを作成します。 呼び出し元はインターフェイスを解放する必要があります。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

オーディオ レンダラーを作成するには、取得したIMFActivate ポインターで IMFActivate::ActivateObject を呼び出します。

メモ メモリ リークを回避するには、オーディオ レンダラーまたはオーディオ レンダラーの activate オブジェクトへの最後の参照を解放する前に 、IMFActivate::ShutdownObject を呼び出します。

 

オーディオ レンダラーを構成するには、ActivateObject を呼び出す前に、IMFActivate オブジェクトに次のいずれかの属性を設定します。 (メディア セッションを使用している場合、トポロジをキューに入れると、メディア セッションによって ActivateObject が自動的に呼び出されます)。

属性	説明
MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID	オーディオ エンドポイント デバイス識別子。
MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE	オーディオ エンドポイントロール。
MF_AUDIO_RENDERER_ATTRIBUTE_FLAGS	その他の構成フラグ。
MF_AUDIO_RENDERER_ATTRIBUTE_SESSION_ID	オーディオ ポリシー クラス。
MF_AUDIO_RENDERER_ATTRIBUTE_STREAM_CATEGORY	オーディオ ストリーム カテゴリ。
MF_LOW_LATENCY	待機時間の短いオーディオ ストリーミングを有効にします。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfidl.h
Library	Mf.lib
[DLL]	Mf.dll

こちらもご覧ください

アクティブ化オブジェクト

メディア ファンデーション機能

ストリーミング オーディオ レンダラー