IDeviceTopology::Metode GetConnector (devicetopology.h)

  • Artikel

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
E_INVALIDARG
 Parameter nIndex berada di luar rentang.
E_POINTER
 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

Lihat juga

Antarmuka IConnector

Antarmuka IDeviceTopology

IDeviceTopology::GetConnectorCount