Metode CTransformOutputPin.GetMediaType

[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

HRESULT GetMediaType(
   int        iPosition,
   CMediaType *pMediaType
);

Parameter

iPosisi

Nilai indeks berbasis nol.

pMediaType

Penunjuk ke objek CMediaType yang menerima jenis media.

Mengembalikan nilai

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang diperlihatkan dalam tabel berikut ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil
VFW_S_NO_MORE_ITEMS	Indeks di luar rentang

Keterangan

Metode ini mengambil alih metode CBasePin::GetMediaType . Jika pin input filter tidak tersambung, metode akan mengembalikan VFW_S_NO_MORE_ITEMS. Jika tidak, metode ini memanggil metode CTransformFilter::GetMediaType filter untuk mengambil jenis media. Metode CTransformFilter::GetMediaType adalah virtual murni; kelas turunan filter harus mengambil alihnya.

Persyaratan

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