IDeviceTopology::Metode GetConnector (devicetopology.h)
Metode GetConnector mendapatkan konektor yang ditentukan oleh nomor konektor.
Sintaks
HRESULT GetConnector(
[in] UINT nIndex,
[out] IConnector **ppConnector
);
Parameter
[in] nIndex
Nomor konektor. Jika topologi perangkat berisi konektor n, konektor diberi nomor 0 hingga n – 1. Untuk mendapatkan jumlah konektor dalam topologi perangkat, panggil metode IDeviceTopology::GetConnectorCount .
[out] ppConnector
Pointer ke variabel pointer tempat metode menulis alamat antarmuka IConnector dari objek konektor. Melalui metode ini, penelepon mendapatkan referensi yang dihitung ke antarmuka. Pemanggil bertanggung jawab untuk merilis antarmuka, ketika tidak lagi diperlukan, dengan memanggil metode Rilis antarmuka. Jika panggilan GetConnector gagal, *ppConnector adalah NULL.
Nilai kembali
Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian menyertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Parameter nIndex berada di luar rentang. |
|
Pointer ppConnector adalah NULL. |
Keterangan
Untuk contoh kode yang memanggil metode GetConnector , lihat implementasi fungsi GetHardwareDeviceTopology dan SelectCaptureDevice di Topologi Perangkat.
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 |