estrutura DIRECTX_AUDIO_ACTIVATION_PARAMS (mmdeviceapi.h)

A estrutura DIRECTX_AUDIO_ACTIVATION_PARAMS especifica os parâmetros de inicialização para um fluxo DirectSound.

Sintaxe

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

Membros

cbDirectXAudioActivationParams

O tamanho, em bytes, da estrutura DIRECTX_AUDIO_ACTIVATION_PARAMS . Defina esse membro como sizeof(DIRECTX_AUDIO_ACTIVATION_PARAMS).

guidAudioSession

GUID de sessão. Esse membro é um valor GUID que identifica a sessão de áudio à qual o fluxo pertence. Se o GUID identificar uma sessão que foi aberta anteriormente, o método adicionará o fluxo a essa sessão. Se o GUID não identificar uma sessão existente, o método abrirá uma nova sessão e adicionará o fluxo a essa sessão. O fluxo permanece um membro da mesma sessão durante seu tempo de vida.

dwAudioStreamFlags

Sinalizadores de inicialização de fluxo. Esse membro especifica se o fluxo pertence a uma sessão entre processos ou a uma sessão específica do processo atual. Defina esse membro como 0 ou como a seguinte AUDCLNT_STREAMFLAGS_XXX constante:

AUDCLNT_STREAMFLAGS_CROSSPROCESS

Comentários

Essa estrutura é usada pelo método IMMDevice::Activate . Ao ativar uma interface IDirectSound, IDirectSoundCapture ou IBaseFilter em um dispositivo de ponto de extremidade de áudio, a estrutura DIRECTX_AUDIO_ACTIVATION_PARAMS especifica o GUID da sessão e os sinalizadores de inicialização de fluxo para o fluxo de áudio que o módulo DirectSound cria e encapsula na instância da interface. Durante a chamada Ativar , o DirectSound chama o método IAudioClient::Initialize e especifica o GUID da sessão e os sinalizadores de inicialização de fluxo da estrutura DIRECTX_AUDIO_ACTIVATION_PARAMS como parâmetros de entrada.

Para obter mais informações sobre IDirectSound, IDirectSoundCapture e IBaseFilter, consulte a documentação do SDK do Windows.

Para obter um exemplo de código que usa a estrutura DIRECTX_AUDIO_ACTIVATION_PARAMS , consulte Funções de dispositivo para aplicativos DirectShow.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	mmdeviceapi.h

Confira também

Estruturas de áudio principais

IAudioClient::Initialize

IMMDevice::Activate