structure DIRECTX_AUDIO_ACTIVATION_PARAMS (mmdeviceapi.h)

La structure DIRECTX_AUDIO_ACTIVATION_PARAMS spécifie les paramètres d’initialisation d’un flux DirectSound.

Syntaxe

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

Membres

cbDirectXAudioActivationParams

Taille, en octets, de la structure DIRECTX_AUDIO_ACTIVATION_PARAMS . Définissez ce membre sur sizeof(DIRECTX_AUDIO_ACTIVATION_PARAMS).

guidAudioSession

GUID de session. Ce membre est une valeur GUID qui identifie la session audio à laquelle appartient le flux. Si le GUID identifie une session qui a été ouverte précédemment, la méthode ajoute le flux à cette session. Si le GUID n’identifie pas une session existante, la méthode ouvre une nouvelle session et ajoute le flux à cette session. Le flux reste membre de la même session pendant toute sa durée de vie.

dwAudioStreamFlags

Indicateurs d’initialisation de flux. Ce membre spécifie si le flux appartient à une session inter-processus ou à une session spécifique au processus actuel. Définissez ce membre sur 0 ou sur la constante AUDCLNT_STREAMFLAGS_XXX suivante :

AUDCLNT_STREAMFLAGS_CROSSPROCESS

Notes

Cette structure est utilisée par la méthode IMMDevice::Activate . Lors de l’activation d’une interface IDirectSound, IDirectSoundCapture ou IBaseFilter sur un appareil de point de terminaison audio, la structure DIRECTX_AUDIO_ACTIVATION_PARAMS spécifie le GUID de session et les indicateurs d’initialisation de flux pour le flux audio que le module DirectSound crée et encapsule dans l’interface instance. Pendant l’appel Activate , DirectSound appelle la méthode IAudioClient::Initialize et spécifie le GUID de session et les indicateurs d’initialisation de flux de la structure DIRECTX_AUDIO_ACTIVATION_PARAMS en tant que paramètres d’entrée.

Pour plus d’informations sur IDirectSound, IDirectSoundCapture et IBaseFilter, consultez la documentation du Kit de développement logiciel (SDK) Windows.

Pour obtenir un exemple de code qui utilise la structure DIRECTX_AUDIO_ACTIVATION_PARAMS , consultez Rôles d’appareil pour les applications DirectShow.

Spécifications

Voir aussi

Structures audio principales

IAudioClient::Initialize

IMMDevice::Activate