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 方法使用。 在音频终结点设备上激活 IDirectSoundIDirectSoundCaptureIBaseFilter 接口时, DIRECTX_AUDIO_ACTIVATION_PARAMS 结构为 DirectSound 模块创建并封装在接口实例中的音频流指定会话 GUID 和流初始化标志。 在 Activate 调用期间,DirectSound 调用 IAudioClient::Initialize 方法,并将 DIRECTX_AUDIO_ACTIVATION_PARAMS 结构的会话 GUID 和流初始化标志指定为输入参数。

有关 IDirectSoundIDirectSoundCaptureIBaseFilter 的详细信息,请参阅 Windows SDK 文档。

有关使用 DIRECTX_AUDIO_ACTIVATION_PARAMS 结构的代码示例,请参阅 DirectShow 应用程序的设备角色

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 mmdeviceapi.h

另请参阅

核心音频结构

IAudioClient::Initialize

IMMDevice::Activate