IDeviceTopology::Metode GetDeviceId (devicetopology.h)

  • Artikel

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
D_POINTER
 Pointer ppwstrDeviceId adalah NULL.
E_OUTOFMEMORY
 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

Lihat juga

Antarmuka IDeviceTopology

IMMDeviceEnumerator::GetDevice