DIRECTX_AUDIO_ACTIVATION_PARAMS-Struktur (mmdeviceapi.h)

  • Artikel

Die DIRECTX_AUDIO_ACTIVATION_PARAMS-Struktur gibt die Initialisierungsparameter für einen DirectSound-Stream an.

Syntax

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

Members

cbDirectXAudioActivationParams

Die Größe der DIRECTX_AUDIO_ACTIVATION_PARAMS-Struktur in Bytes. Legen Sie diesen Member auf sizeof(DIRECTX_AUDIO_ACTIVATION_PARAMS) fest.

guidAudioSession

Sitzungs-GUID. Dieser Member ist ein GUID-Wert, der die Audiositzung identifiziert, zu der der Stream gehört. Wenn die GUID eine Sitzung identifiziert, die zuvor geöffnet wurde, fügt die -Methode den Stream zu dieser Sitzung hinzu. Wenn die GUID keine vorhandene Sitzung identifiziert, öffnet die -Methode eine neue Sitzung und fügt der Sitzung den Stream hinzu. Der Stream bleibt für seine Lebensdauer Mitglied derselben Sitzung.

dwAudioStreamFlags

Streaminitialisierungsflags. Dieser Member gibt an, ob der Stream zu einer prozessübergreifenden Sitzung oder zu einer Sitzung gehört, die für den aktuellen Prozess spezifisch ist. Legen Sie dieses Element auf 0 oder auf die folgende AUDCLNT_STREAMFLAGS_XXX-Konstante fest:

AUDCLNT_STREAMFLAGS_CROSSPROCESS

Hinweise

Diese Struktur wird von der IMMDevice::Activate-Methode verwendet. Beim Aktivieren einer IDirectSound-, IDirectSoundCapture- oder IBaseFilter-Schnittstelle auf einem Audioendpunktgerät gibt die DIRECTX_AUDIO_ACTIVATION_PARAMS-Struktur die Sitzungs-GUID und streaminitialisierungsflags für den Audiodatenstrom an, den das DirectSound-Modul erstellt und in der Schnittstelle instance kapselt. Während des Activate-Aufrufs ruft DirectSound die IAudioClient::Initialize-Methode auf und gibt die Sitzungs-GUID und streaminitialisierungsflags aus der DIRECTX_AUDIO_ACTIVATION_PARAMS-Struktur als Eingabeparameter an.

Weitere Informationen zu IDirectSound, IDirectSoundCapture und IBaseFilter finden Sie in der Windows SDK-Dokumentation.

Ein Codebeispiel, das die DIRECTX_AUDIO_ACTIVATION_PARAMS-Struktur verwendet, finden Sie unter Geräterollen für DirectShow-Anwendungen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile mmdeviceapi.h

Weitere Informationen

Kernaudiostrukturen

IAudioClient::Initialize

IMMDevice::Activate