struktur DIRECTX_AUDIO_ACTIVATION_PARAMS (mmdeviceapi.h)

  • Artikel

Struktur DIRECTX_AUDIO_ACTIVATION_PARAMS menentukan parameter inisialisasi untuk aliran DirectSound.

Sintaks

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

Anggota

cbDirectXAudioActivationParams

Ukuran, dalam byte, dari struktur DIRECTX_AUDIO_ACTIVATION_PARAMS . Atur anggota ini ke sizeof(DIRECTX_AUDIO_ACTIVATION_PARAMS).

guidAudioSession

GUID sesi. Anggota ini adalah nilai GUID yang mengidentifikasi sesi audio tempat aliran berada. Jika GUID mengidentifikasi sesi yang telah dibuka sebelumnya, metode menambahkan aliran ke sesi tersebut. Jika GUID tidak mengidentifikasi sesi yang ada, metode akan membuka sesi baru dan menambahkan aliran ke sesi tersebut. Aliran tetap menjadi anggota sesi yang sama selama masa pakainya.

dwAudioStreamFlags

Bendera inisialisasi aliran. Anggota ini menentukan apakah aliran milik sesi lintas proses atau sesi yang khusus untuk proses saat ini. Atur anggota ini ke 0 atau ke konstanta AUDCLNT_STREAMFLAGS_XXX berikut:

AUDCLNT_STREAMFLAGS_CROSSPROCESS

Keterangan

Struktur ini digunakan oleh metode IMMDevice::Activate . Saat mengaktifkan antarmuka IDirectSound, IDirectSoundCapture, atau IBaseFilter pada perangkat titik akhir audio, struktur DIRECTX_AUDIO_ACTIVATION_PARAMS menentukan GUID sesi dan bendera inisialisasi aliran untuk aliran audio yang dibuat dan dienkapsulasi modul DirectSound dalam instans antarmuka. Selama panggilan Aktifkan , DirectSound memanggil metode IAudioClient::Initialize dan menentukan GUID sesi dan bendera inisialisasi aliran dari struktur DIRECTX_AUDIO_ACTIVATION_PARAMS sebagai parameter input.

Untuk informasi selengkapnya tentang IDirectSound, IDirectSoundCapture, dan IBaseFilter, lihat dokumentasi Windows SDK.

Untuk contoh kode yang menggunakan struktur DIRECTX_AUDIO_ACTIVATION_PARAMS , lihat Peran Perangkat untuk Aplikasi DirectShow.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header mmdeviceapi.h

Lihat juga

Struktur Audio Inti

IAudioClient::Initialize

IMMDevice::Activate