estructura DIRECTX_AUDIO_ACTIVATION_PARAMS (mmdeviceapi.h)

La estructura DIRECTX_AUDIO_ACTIVATION_PARAMS especifica los parámetros de inicialización de una secuencia de DirectSound.

Sintaxis

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

Members

cbDirectXAudioActivationParams

Tamaño, en bytes, de la estructura DIRECTX_AUDIO_ACTIVATION_PARAMS . Establezca este miembro en sizeof(DIRECTX_AUDIO_ACTIVATION_PARAMS).

guidAudioSession

GUID de la sesión. Este miembro es un valor GUID que identifica la sesión de audio a la que pertenece la secuencia. Si el GUID identifica una sesión que se ha abierto anteriormente, el método agrega la secuencia a esa sesión. Si el GUID no identifica una sesión existente, el método abre una nueva sesión y agrega la secuencia a esa sesión. La secuencia permanece miembro de la misma sesión durante su vigencia.

dwAudioStreamFlags

Marcas de inicialización de flujo. Este miembro especifica si la secuencia pertenece a una sesión entre procesos o a una sesión específica del proceso actual. Establezca este miembro en 0 o en la siguiente constante AUDCLNT_STREAMFLAGS_XXX :

AUDCLNT_STREAMFLAGS_CROSSPROCESS

Comentarios

El método IMMDevice::Activate usa esta estructura. Al activar una interfaz IDirectSound, IDirectSoundCapture o IBaseFilter en un dispositivo de punto de conexión de audio, la estructura de DIRECTX_AUDIO_ACTIVATION_PARAMS especifica el GUID de sesión y las marcas de inicialización de secuencia para la secuencia de audio que el módulo DirectSound crea y encapsula en la instancia de interfaz. Durante la llamada Activate , DirectSound llama al método IAudioClient::Initialize y especifica el GUID de sesión y las marcas de inicialización de secuencia de la estructura de DIRECTX_AUDIO_ACTIVATION_PARAMS como parámetros de entrada.

Para obtener más información sobre IDirectSound, IDirectSoundCapture e IBaseFilter, consulte la documentación de Windows SDK.

Para obtener un ejemplo de código que usa la estructura de DIRECTX_AUDIO_ACTIVATION_PARAMS , consulte Roles de dispositivo para directShow Applications.

Requisitos

Consulte también

Estructuras de audio principales

IAudioClient::Initialize

IMMDevice::Activate