Metode IConnector::GetDeviceIdConnectedTo (devicetopology.h)

Metode GetDeviceIdConnectedTo mendapatkan pengidentifikasi perangkat perangkat audio, jika ada, yang terhubung dengan konektor ini.

Sintaks

HRESULT GetDeviceIdConnectedTo(
  [out] LPWSTR *ppwstrDeviceId
);

Parameter

[out] ppwstrDeviceId

Penunjuk ke penunjuk string tempat metode menulis alamat string karakter lebar yang dihentikan null yang berisi pengidentifikasi perangkat dari perangkat yang terhubung. Metode mengalokasikan penyimpanan untuk string. Pemanggil bertanggung jawab untuk membebaskan penyimpanan, ketika tidak lagi diperlukan, dengan memanggil fungsi CoTaskMemFree . Jika panggilan GetDeviceIdConnectedTo 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
E_POINTER	Pointer ppwstrDeviceId adalah NULL.
E_NOTFOUND	Konektor ini tidak tersambung, atau sisi lain koneksi bukan topologi perangkat lain (misalnya, koneksi Software_IO).
E_MEMORY	Kehabisan memori.

Keterangan

Pengidentifikasi perangkat yang diperoleh dari metode ini dapat digunakan sebagai parameter input ke metode IMMDeviceEnumerator::GetDevice .

Metode ini secara fungsional setara dengan, tetapi lebih efisien daripada, rangkaian panggilan metode berikut:

• Panggil metode IConnector::GetConnectedTo untuk mendapatkan antarmuka IConnector dari konektor "ke".
• Panggil metode IConnector::QueryInterface (dengan parameter iid diatur ke REFIID IID_IPart) untuk mendapatkan antarmuka IPart dari konektor "ke".
• Panggil metode IPart::GetTopologyObject untuk mendapatkan antarmuka IDeviceTopology dari perangkat "ke" (perangkat yang berisi konektor "ke").
• Panggil metode IDeviceTopology::GetDeviceId untuk mendapatkan ID perangkat dari perangkat "ke".

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 IConnector

IMMDeviceEnumerator::GetDevice