Metode CBasePin.GetMediaType

  • Artikel

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan 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 Pengambilan Audio/Video 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 ini GetMediaType mengambil jenis media pilihan, menurut nilai indeks.

Sintaks

virtual HRESULT GetMediaType(
   int        iPosition,
   CMediaType *pMediaType
);

Parameter

iPosisi

Nilai indeks berbasis nol.

pMediaType

Penunjuk ke objek CMediaType yang menerima jenis media.

Nilai kembali

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Berhasil.
VFW_S_NO_MORE_ITEMS
 Indeks di luar rentang.
E_INVALIDARG
 Indeks kurang dari nol.
E_UNEXPECTED
 Kesalahan tak terduga.

Keterangan

Dari daftar pin jenis media pilihan, metode ini mengembalikan jenis dengan nilai indeks iPosition. Kelas CEnumMediaTypes memanggil metode ini untuk menghitung jenis media pilihan.

Kelas dasar mengembalikan E_UNEXPECTED. Ambil alih metode ini di kelas turunan Anda.

Persyaratan

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

Lihat juga

Kelas CBasePin