struttura DIRECTX_AUDIO_ACTIVATION_PARAMS (mmdeviceapi.h)

La struttura DIRECTX_AUDIO_ACTIVATION_PARAMS specifica i parametri di inizializzazione per un flusso DirectSound.

Sintassi

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

Members

cbDirectXAudioActivationParams

Dimensione, in byte, della struttura DIRECTX_AUDIO_ACTIVATION_PARAMS . Impostare questo membro su sizeof(DIRECTX_AUDIO_ACTIVATION_PARAMS).

guidAudioSession

GUID della sessione. Questo membro è un valore GUID che identifica la sessione audio a cui appartiene il flusso. Se il GUID identifica una sessione aperta in precedenza, il metodo aggiunge il flusso a tale sessione. Se il GUID non identifica una sessione esistente, il metodo apre una nuova sessione e aggiunge il flusso a tale sessione. Il flusso rimane un membro della stessa sessione per la sua durata.

dwAudioStreamFlags

Flag di inizializzazione del flusso. Questo membro specifica se il flusso appartiene a una sessione tra processi o a una sessione specifica del processo corrente. Impostare questo membro su 0 o sulla costante AUDCLNT_STREAMFLAGS_XXX seguente:

AUDCLNT_STREAMFLAGS_CROSSPROCESS

Commenti

Questa struttura viene usata dal metodo IMMDevice::Activate . Quando si attiva un'interfaccia IDirectSound, IDirectSoundCapture o IBaseFilter in un dispositivo endpoint audio, la struttura DIRECTX_AUDIO_ACTIVATION_PARAMS specifica il GUID di sessione e i flag di inizializzazione di flusso per il flusso audio creato e incapsulato dal modulo DirectSound nell'istanza dell'interfaccia. Durante la chiamata Activate , DirectSound chiama il metodo IAudioClient::Initialize e specifica il GUID di sessione e i flag di inizializzazione di flusso dalla struttura DIRECTX_AUDIO_ACTIVATION_PARAMS come parametri di input.

Per altre informazioni su IDirectSound, IDirectSoundCapture e IBaseFilter, vedere la documentazione di Windows SDK.

Per un esempio di codice che usa la struttura DIRECTX_AUDIO_ACTIVATION_PARAMS , vedere Ruoli del dispositivo per le applicazioni DirectShow.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	mmdeviceapi.h

Vedi anche

Strutture audio di base

IAudioClient::Initialize

IMMDevice::Activate