Metode CEnumPins.Next

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine dan Audio/Video Capture di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode Berikutnya mengambil jumlah pin tertentu dalam urutan enumerasi. Metode ini mengimplementasikan metode IEnumPins::Next .

Sintaks

HRESULT Next(
   ULONG cPins,
   IPin  **ppPins,
   ULONG *pcFetched
);

Parameter

cPins: Jumlah pin yang akan diambil.
ppPins: Array cPin ukuran yang diisi dengan pointer IPin .
pcFetched: Penunjuk ke variabel yang menerima jumlah pin yang diambil. Bisa NULL jika cPins adalah 1.

Nilai kembali

Mengembalikan salah satu nilai HRESULT yang diperlihatkan dalam tabel berikut ini.

Menampilkan kode	Deskripsi
S_FALSE	Tidak mengambil pin sebanyak yang diminta.
S_OK	Berhasil.
E_INVALIDARG	Argumen tidak valid.
E_POINTER	Argumen penunjuk NULL.
VFW_E_ENUM_OUT_OF_SYNC	Status filter telah berubah dan sekarang tidak konsisten dengan enumerator.

Keterangan

Metode ini mengambil pointer ke jumlah pin yang ditentukan, dimulai pada posisi saat ini dalam enumerasi, dan menempatkannya dalam array yang ditentukan.

Metode ini memanggil metode CBaseFilter::GetPin filter untuk mengambil pin.

Jika metode berhasil, semua penunjuk IPin memiliki jumlah referensi yang luar biasa. Pastikan untuk melepaskannya ketika Anda selesai.

Persyaratan

Persyaratan	Nilai
Header	Amfilter.h (termasuk Streams.h)
Pustaka	Strmbase.lib (build ritel); Strmbasd.lib (build debug)

Lihat juga

Kelas CEnumPins

Bagikan melalui