DirectSound レンダラー フィルター

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

このフィルターは、DirectSound を使用してオーディオをレンダリングします。 このフィルターは現在、波形サウンドの既定のオーディオ レンダラーです。

このフィルターは、基本的なサウンド レンダリング機能に加えて、DirectSound API 呼び出しを処理できます。 IAMDirectSound メソッドを使用して、サウンドの再生を処理するウィンドウを設定および取得します。 DirectSound オーディオ レンダラーは、DirectShow の既定のオーディオ レンダリング フィルターです。

Label 値
フィルター インターフェイス IAMAudioRendererStats、 IAMClockSlave、 IAMDirectSound、 IAMResourceControl、 IBaseFilter、 IBasicAudio、 IDirectSound3DBuffer、 IDirectSound3dListener、 IMediaPosition、 IMediaSeeking、 IQualityControl、 IReferenceClock
入力ピン メディアの種類 メジャーの種類: MEDIATYPE_AudioSubtypes:
  • MEDIASUBTYPE_PCM
  • MEDIASUBTYPE_IEEE_FLOAT
  • MEDIASUBTYPE_DOLBY_AC3_SPDIF
  • MEDIASUBTYPE_RAW_SPORT
  • MEDIASUBTYPE_SPDIF_TAG_241h
  • MEDIASUBTYPE_DRM_Audio
形式の種類: FORMAT_WaveFormatEx
入力ピン インターフェイス IMemInputPin、 IPin、 IPinConnection、 IQualityControl
出力ピン メディアの種類 該当なし。
出力ピン インターフェイス 該当なし。
CLSID のフィルター処理 CLSID_DSoundRender
プロパティ ページ CLSID CLSID_AudioProperties、CLSID_AudioRendererAdvancedProperties
[実行可能ファイル] quartz.dll
メリット MERIT_PREFERRED
フィルター カテゴリ CLSID_AudioRendererCategory

解説

このフィルターは、オーディオ デバイスのラッパーとして機能します。 ユーザーのシステムで使用可能なオーディオ デバイスを列挙するには、 ICreateDevEnum インターフェイスとオーディオ レンダラー カテゴリ (CLSID_AudioRendererCategory) を使用します。 オーディオ デバイスごとに、オーディオ レンダラー カテゴリには 2 つのフィルター インスタンスが含まれます。 これらの 1 つは DirectSound レンダラーに対応し、もう 1 つは オーディオ レンダラー (WaveOut) フィルターに対応しています。 DirectSound インスタンスのフレンドリ名は "DirectSound: DeviceName" で、 DeviceName はデバイスの名前です。 WaveOut インスタンスのフレンドリ名は DeviceName です。

オーディオ レンダラー カテゴリには、"Default DirectSound Device" と "Default WaveOut Device" という名前の 2 つの追加フィルター インスタンスが含まれています。これらは、コントロール パネルを介してユーザーが選択した既定のサウンド デバイスに対応します。 これらは実際には、前の段落で説明したペアのいずれかにマッピングされています。 たとえば、システムにデバイス A とデバイス B という 2 つのオーディオ デバイスがある場合、オーディオ レンダラー カテゴリには次のものが含まれます。

  • デバイス A
  • DirectSound: デバイス A
  • デバイス B
  • DirectSound: デバイス B
  • 既定の DirectSound デバイス
  • 既定の WaveOut デバイス

ユーザーが既定のデバイスとしてデバイス A を選択した場合、"Default DirectSound Device" は "DirectSound: Device A" に相当し、"Default WaveOut Device" は "Device A" と同じです。ユーザーが既定のデバイスとしてデバイス B を選択すると、これらのマッピングが変更されます。

"Default DirectSound Device" には、MERIT_PREFERREDのメリットが割り当てられます。 他の人はMERIT_DO_NOT_USEメリットがあります。 そのため、Intelligent Connect は常に既定の DirectSound デバイスを選択します。

DirectSound レンダラー フィルターは、DirectSound IDirectSound3DBuffer インターフェイスと IDirectSound3dListener インターフェイスを介して 3D サウンドをサポートします。 これらのインターフェイスの現在のバージョンである IDirectSound3DBuffer8 および IDirectSound3dListener8 のフィルターに対してクエリを 実行することもできます。 これらのインターフェイスでメソッドを呼び出す前に、グラフを実行します。

DirectShow フィルター