IPart::EnumPartsOutgoing method (devicetopology.h)

Metode EnumPartsOutgoing mengambil daftar semua bagian keluar—yaitu, bagian yang berada di jalur data yang hilir dari bagian ini.

Sintaks

HRESULT EnumPartsOutgoing(
  [out] IPartsList **ppParts
);

Parameter

[out] ppParts

Penunjuk ke variabel pointer tempat metode menulis alamat antarmuka IPartsList yang merangkum daftar bagian yang segera hilir dari bagian 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 EnumPartsOutgoing gagal, *ppParts adalah NULL.

Nilai kembali

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 ppParts adalah NULL.
E_NOTFOUND	Bagian ini tidak memiliki tautan ke bagian hilir.
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

Aplikasi klien dapat melintasi topologi perangkat ke arah aliran data audio dengan secara berulang memanggil metode ini pada setiap langkah di traversal untuk mendapatkan daftar bagian yang segera berada di hilir dari bagian saat ini.

Jika bagian ini tidak memiliki tautan ke bagian hilir, metode mengembalikan kode kesalahan E_NOTFOUND dan tidak membuat daftar bagian (*ppParts adalah NULL). Misalnya, metode mengembalikan kode kesalahan ini jika antarmuka IPart mewakili konektor di mana data keluar dari topologi perangkat.

Untuk contoh kode yang menggunakan metode EnumPartsOutgoing , lihat implementasi fungsi 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 IPart

Antarmuka IPartsList