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 |