IConnector::Metode GetConnectedTo (devicetopology.h)

Artikel
08/23/2023

Metode GetConnectedTo mendapatkan konektor tempat konektor ini tersambung.

Sintaks

HRESULT GetConnectedTo(
  [out] IConnector **ppConTo
);

Parameter

[out] ppConTo

Pointer ke variabel pointer tempat metode menulis alamat antarmuka IConnector dari objek konektor lainnya. 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 GetConnectedTo gagal, *ppConTo adalah NULL.

Mengembalikan nilai

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_POINTER	Pointer ppConTo adalah NULL.
E_NOTFOUND	Konektor ini tidak tersambung, atau sisi lain koneksi bukan topologi perangkat lain (misalnya, koneksi Software_IO).
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)	Topologi perangkat di sisi lain koneksi tidak aktif (artinya, status perangkat tidak DEVICE_STATE_ACTIVE).

Keterangan

Untuk contoh kode yang memanggil metode ini, lihat implementasi fungsi GetHardwareDeviceTopology dan SelectCaptureDevice di Topologi Perangkat.

Untuk informasi tentang koneksi Software_IO, lihat Enumerasi ConnectorType. Untuk informasi tentang makro HRESULT_FROM_WIN32, lihat dokumentasi Windows SDK. Untuk informasi tentang status perangkat DEVICE_STATE_NOTPRESENT, lihat konstanta DEVICE_STATE_XXX.

Persyaratan


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

Bagikan melalui