Metode IDeviceTopology::GetSignalPath (devicetopology.h)

Artikel
08/23/2023

Metode GetSignalPath mendapatkan daftar bagian di jalur sinyal yang menghubungkan dua bagian, jika jalur ada.

Sintaks

HRESULT GetSignalPath(
  [in]  IPart      *pIPartFrom,
  [in]  IPart      *pIPartTo,
  [in]  BOOL       bRejectMixedPaths,
  [out] IPartsList **ppParts
);

Parameter

[in] pIPartFrom

Arahkan ke bagian "dari". Parameter ini adalah penunjuk ke antarmuka IPart dari bagian di awal jalur sinyal.

[in] pIPartTo

Arahkan ke bagian "ke". Parameter ini adalah penunjuk ke antarmuka IPart dari bagian di akhir jalur sinyal.

[in] bRejectMixedPaths

Menentukan apakah akan menolak jalur yang berisi data campuran. Jika bRejectMixedPathsTRUE (bukan nol), metode mengabaikan jalur data apa pun yang berisi mixer (yaitu, simpul pemrosesan yang menjumlahkan bersama dua sinyal input atau lebih). Jika FALSE, metode akan mencoba menemukan jalur yang menghubungkan bagian "dari" dan "ke" terlepas dari apakah jalur berisi mixer.

[out] ppParts

Pointer ke variabel pointer tempat metode menulis alamat instans antarmuka IPartsList . Antarmuka ini merangkum daftar bagian di jalur sinyal yang menghubungkan bagian "dari" ke bagian "ke". 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 GetSignalPath gagal, *ppParts 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	Parameter pIPartFrom, pIPartTo, atau ppParts adalah NULL.
E_NOTFOUND	Tidak ada jalur yang menghubungkan dua bagian yang ditemukan.
E_NOINTERFACE	Parameter pIPartFrom atau pIPartTo tidak menunjuk ke antarmuka IPart yang valid.
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

Metode ini membuat instans antarmuka IPartsList yang berisi daftar bagian yang terletak di sepanjang jalur sinyal yang ditentukan. Bagian-bagian dalam daftar bagian diurutkan sesuai dengan posisi relatif mereka di jalur sinyal. Bagian "ke" adalah item pertama dalam daftar dan bagian "dari" adalah item terakhir dalam daftar.

Jika daftar berisi bagian n , bagian "ke" dan "dari" masing-masing diidentifikasi oleh indeks daftar 0 dan n– 1. Untuk mendapatkan jumlah bagian dalam daftar bagian, panggil metode IPartsList::GetCount . Untuk mengambil bagian menurut indeksnya, panggil metode IPartsList::GetPart .

Bagian-bagian dalam jalur sinyal semuanya harus menjadi bagian dari topologi perangkat yang sama. Jalur tidak dapat menjangkau batas antara topologi perangkat.

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