PKEY_AudioEndpoint_GUID

Properti PKEY_AudioEndpoint_GUID memasok pengidentifikasi perangkat DirectSound yang sesuai dengan perangkat titik akhir audio. Nilai properti adalah GUID yang dapat disediakan klien sebagai pengidentifikasi perangkat ke fungsi DirectSoundCreate atau DirectSoundCaptureCreate di API DirectSound. Nilai ini secara unik mengidentifikasi perangkat titik akhir audio di semua perangkat titik akhir audio dalam sistem. Untuk informasi selengkapnya tentang DirectSound, lihat dokumentasi DirectX SDK.

Anggota vt struktur PROPVARIANT diatur ke VT_LPWSTR.

Anggota pwszVal dari struktur PROPVARIANT menunjuk ke string karakter lebar yang dihentikan null yang berisi GUID yang mengidentifikasi perangkat titik akhir audio di DirectSound.

Seperti yang dijelaskan sebelumnya, MMDevice API mendukung peran perangkat. Meskipun DirectSound tidak secara langsung mendukung peran perangkat, klien DirectSound dapat menggunakan properti PKEY_AudioEndpoint_GUID untuk memilih penyajian DirectSound atau mengambil perangkat berdasarkan peran perangkatnya.

Misalnya, aplikasi DirectSound melakukan langkah-langkah berikut untuk membuat perangkat DirectSound yang sesuai dengan perangkat titik akhir penyajian yang telah ditetapkan pengguna peran eMultimedia untuk:

1. Panggil metode IMMDeviceEnumerator::GetDefaultAudioEndpoint untuk mendapatkan antarmuka IMMDevice dari perangkat titik akhir penyajian yang memiliki peran eMultimedia.
2. Panggil metode IMMDevice::OpenPropertyStore untuk mendapatkan antarmuka IPropertyStore dari perangkat eMultimedia. Untuk informasi selengkapnya tentang IPropertyStore, lihat dokumentasi Windows SDK.
3. Panggil metode IPropertyStore::GetValue untuk mendapatkan nilai properti PKEY_AudioEndpoint_GUID.
4. Konversikan nilai properti dari GUID dalam format string menjadi struktur GUID 16-byte.
5. Panggil fungsi DirectSoundCreate dengan GUID untuk membuat perangkat dengan peran eMultimedia.

Catatan

PKEY_AudioEndpoint_GUID adalah properti baca-saja terlepas dari mode akses penyimpanan yang diminta oleh aplikasi di IMMDevice::OpenPropertyStore. Jika aplikasi mencoba menetapkan nilai dengan menggunakan IPropertyStore::SetValue, panggilan ini gagal dengan kode kesalahan E_ACCESSDENIED.

 

Perhatikan bahwa GUID 16-byte yang dihasilkan pada langkah 4 cocok dengan GUID perangkat yang mengidentifikasi perangkat selama enumerasi perangkat DirectSound. Fungsi DirectSoundEnumerate menghitung perangkat titik akhir penyajian, dan fungsi DirectSoundCaptureEnumerate menghitung perangkat titik akhir pengambilan. Dalam kedua kasus, GUID perangkat adalah parameter pertama yang diteruskan ke fungsi panggilan balik enumerasi. Untuk informasi selengkapnya tentang enumerasi DirectSound, lihat dokumentasi DirectX SDK.

Untuk contoh kode yang menggunakan properti PKEY_AudioEndpoint_GUID, lihat Peran Perangkat untuk Aplikasi DirectSound.

Persyaratan

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

Lihat juga

Properti Titik Akhir Audio

Properti Audio Inti