IDeviceTopology::Metode GetDeviceId (devicetopology.h)
Metode GetDeviceId mendapatkan pengidentifikasi perangkat perangkat yang diwakili oleh objek topologi perangkat.
Sintaks
HRESULT GetDeviceId(
[out] LPWSTR *ppwstrDeviceId
);
Parameter
[out] ppwstrDeviceId
Penunjuk ke variabel pointer tempat metode menulis alamat string karakter lebar yang dihentikan null yang berisi pengidentifikasi perangkat. Metode mengalokasikan penyimpanan untuk string. Pemanggil bertanggung jawab untuk membebaskan penyimpanan, ketika tidak lagi diperlukan, dengan memanggil fungsi CoTaskMemFree . Jika panggilan GetDeviceId gagal, *ppwstrDeviceId adalah NULL. Untuk informasi tentang CoTaskMemFree, lihat dokumentasi Windows SDK.
Nilai kembali
Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Pointer ppwstrDeviceId adalah NULL. |
|
Kehabisan memori. |
Keterangan
Pengidentifikasi perangkat yang diperoleh dari metode ini dapat digunakan sebagai parameter input ke metode IMMDeviceEnumerator::GetDevice .
Untuk contoh kode yang menggunakan metode GetDeviceId , lihat Menggunakan Antarmuka IKsControl untuk Mengakses Properti Audio.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | devicetopology.h |