IDeviceTopology::Metode GetPartById (devicetopology.h)

Artikel
02/28/2024

Metode GetPartById mendapatkan bagian yang diidentifikasi oleh ID lokalnya.

Sintaks

HRESULT GetPartById(
  [in]  UINT  nId,
  [out] IPart **ppPart
);

Parameter

[in] nId

Bagian yang harus didapatkan. Parameter ini adalah ID lokal dari bagian tersebut. Untuk informasi selengkapnya, lihat Keterangan.

[out] ppPart

Pointer ke variabel pointer tempat metode menulis alamat antarmuka IPart dari objek bagian yang diidentifikasi oleh nId. 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 GetPartById gagal, *ppPart 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 nId bukan ID lokal yang valid.
E_POINTER	Pointer ppPart adalah NULL.

Keterangan

ID lokal adalah angka yang secara unik mengidentifikasi bagian di antara semua bagian dalam topologi perangkat. Metode IAudioInputSelector::GetSelection dan IAudioOutputSelector::GetSelection mengambil ID lokal dari bagian yang terhubung. Metode IAudioInputSelector::SetSelection dan IAudioOutputSelector::SetSelection memilih input atau output yang terhubung ke bagian yang diidentifikasi oleh ID lokalnya. Ketika Anda memiliki penunjuk ke objek bagian, Anda dapat memanggil metode IPart::GetLocalId untuk mendapatkan ID lokal bagian tersebut.

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