Metode CEnumMediaTypes.Next

  • Artikel
  • 2 menit untuk membaca

Metode ini Next mengambil sejumlah jenis media tertentu. Metode ini mengimplementasikan metode IEnumMediaTypes::Next .

Sintaks

HRESULT Next(
   ULONG         cMediaTypes,
   AM_MEDIA_TYPE **ppMediaTypes,
   ULONG         *pcFetched
);

Parameter

cMediaTypes

Jumlah jenis media yang akan diambil.

ppMediaTypes

Array pointer ke struktur AM_MEDIA_TYPE , dari cPin ukuran.

pcFetched

Penunjuk ke variabel yang menerima jumlah jenis media yang dikembalikan metode. Dapat berupa NULL jika cMediaTypes adalah 1.

Mengembalikan nilai

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

Mengembalikan kode Deskripsi
S_FALSE
 Tidak mengambil tipe media sebanyak yang diminta.
S_OK
 Berhasil.
E_INVALIDARG
 Argumen tidak valid.
E_POINTER
 Argumen pointer NULL.
VFW_E_ENUM_OUT_OF_SYNC
 Status pin telah berubah dan sekarang tidak konsisten dengan enumerator.

Keterangan

Jika metode berhasil, array yang ditentukan oleh ppMediaTypes berisi pointer ke struktur AM_MEDIA_TYPE. Jumlah struktur sama dengan *pcFetched. Bebaskan setiap jenis media dengan memanggil fungsi DeleteMediaType .

Metode ini memanggil metode CBasePin::GetMediaType pin untuk mengambil jenis media.

Persyaratan

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

Lihat juga

Kelas CEnumMediaTypes