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
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | mmdeviceapi.h |