IPart::Metode GetTopologyObject (devicetopology.h)

Metode GetTopologyObject mendapatkan referensi ke antarmuka IDeviceTopology dari objek topologi perangkat yang berisi bagian ini.

Sintaks

HRESULT GetTopologyObject(
  [out] IDeviceTopology **ppTopology
);

Parameter

[out] ppTopology

Arahkan ke variabel pointer tempat metode menulis alamat antarmuka IDeviceTopology dari objek topologi perangkat. Pemanggil mendapatkan referensi yang dihitung ke antarmuka dari metode ini. Melalui metode ini, pemanggil mendapatkan referensi yang dihitung ke antarmuka. Pemanggil bertanggung jawab untuk merilis antarmuka, ketika tidak lagi diperlukan, dengan memanggil metode Rilis antarmuka. Jika panggilan GetTopologyObject gagal, *ppTopology adalah NULL.

Mengembalikan nilai

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 ppTopology adalah NULL.

Keterangan

Untuk contoh kode yang menggunakan metode ini, lihat topik berikut:

• Topologi Perangkat
• Menggunakan Antarmuka IKsControl untuk Mengakses Properti Audio

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 IDeviceTopology

Antarmuka IPart