DIRECTX_AUDIO_ACTIVATION_PARAMS 構造体 (mmdeviceapi.h)

  • [アーティクル]

DIRECTX_AUDIO_ACTIVATION_PARAMS構造体は、DirectSound ストリームの初期化パラメーターを指定します。

構文

typedef struct tagDIRECTX_AUDIO_ACTIVATION_PARAMS {
  DWORD cbDirectXAudioActivationParams;
  GUID  guidAudioSession;
  DWORD dwAudioStreamFlags;
} DIRECTX_AUDIO_ACTIVATION_PARAMS, *PDIRECTX_AUDIO_ACTIVATION_PARAMS;

メンバー

cbDirectXAudioActivationParams

DIRECTX_AUDIO_ACTIVATION_PARAMS構造体のサイズ (バイト単位)。 このメンバーを sizeof(DIRECTX_AUDIO_ACTIVATION_PARAMS) に設定します。

guidAudioSession

セッション GUID。 このメンバーは、ストリームが属するオーディオ セッションを識別する GUID 値です。 GUID が以前に開いたセッションを識別する場合、 メソッドはそのセッションにストリームを追加します。 GUID で既存のセッションが識別されない場合、 メソッドは新しいセッションを開き、そのセッションにストリームを追加します。 ストリームは、その有効期間にわたって同じセッションのメンバーのままです。

dwAudioStreamFlags

ストリーム初期化フラグ。 このメンバーは、ストリームがクロスプロセス セッションに属するか、現在のプロセスに固有のセッションに属するかを指定します。 このメンバーを 0 または次の AUDCLNT_STREAMFLAGS_XXX 定数に設定します。

AUDCLNT_STREAMFLAGS_CROSSPROCESS

解説

この構造体は、 IMMDevice::Activate メソッドによって使用されます。 オーディオ エンドポイント デバイスで IDirectSound、 IDirectSoundCapture、または IBaseFilter インターフェイスをアクティブ化する場合、 DIRECTX_AUDIO_ACTIVATION_PARAMS 構造体は、DirectSound モジュールがインターフェイス インスタンスで作成してカプセル化するオーディオ ストリームのセッション GUID とストリーム初期化フラグを指定します。 Activate 呼び出し中に、DirectSound は IAudioClient::Initialize メソッドを呼び出し、DIRECTX_AUDIO_ACTIVATION_PARAMS構造体のセッション GUID とストリーム初期化フラグを入力パラメーターとして指定します。

IDirectSound、IDirectSoundCapture、および IBaseFilter の詳細については、Windows SDK のドキュメントを参照してください。

DIRECTX_AUDIO_ACTIVATION_PARAMS構造を使用するコード例については、「DirectShow アプリケーションのデバイス ロール」を参照してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header mmdeviceapi.h

関連項目

コア オーディオ構造

IAudioClient::Initialize

IMMDevice::Activate