METODE IMFMediaTypeHandler::IsMediaTypeSupported (mfidl.h)

  • Artikel

Kueri apakah objek mendukung tipe media tertentu.

Sintaks

HRESULT IsMediaTypeSupported(
  [in]  IMFMediaType *pMediaType,
  [out] IMFMediaType **ppMediaType
);

Parameter

[in] pMediaType

Arahkan ke antarmuka IMFMediaType dari jenis media untuk diperiksa.

[out] ppMediaType

Menerima penunjuk ke antarmuka IMFMediaType dari jenis media yang paling cocok, atau menerima nilai NULL. Jika non-NULL, pemanggil harus merilis antarmuka. Parameter ini bisa NULL. Lihat Keterangan.

Mengembalikan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
MF_E_INVALIDMEDIATYPE
 Objek tidak mendukung tipe media ini.

Keterangan

Jika objek mendukung jenis media yang diberikan dalam pMediaType, metode mengembalikan S_OK. Untuk sumber media, itu berarti sumber dapat menghasilkan data yang sesuai dengan jenis media tersebut. Untuk sink media, itu berarti sink dapat menerima data yang sesuai dengan jenis media tersebut. Jika objek tidak mendukung jenis media, metode gagal.

Parameter ppMediaType bersifat opsional. Jika metode gagal, objek mungkin menggunakan ppMediaType untuk mengembalikan jenis media yang didukung objek, dan yang sangat cocok dengan yang diberikan dalam pMediaType. Metode ini tidak dijamin untuk mengembalikan jenis media dalam ppMediaType. Jika tidak ada jenis yang dikembalikan, parameter ini menerima penunjuk NULL . Jika metode berhasil, parameter ini menerima penunjuk NULL . Jika penelepon mengatur ppMediaType ke NULL, parameter ini diabaikan.

Antarmuka ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:

  • Windows XP dengan Paket Layanan 2 (SP2) dan yang lebih baru.
  • Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.
Antarmuka ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:
  • Windows XP dengan SP2 dan yang lebih baru.
  • Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header mfidl.h
Pustaka Mfuuid.lib

Lihat juga

IMFMediaTypeHandler