METODE IMFMediaTypeHandler::SetCurrentMediaType (mfidl.h)

  • Artikel

Menyetel tipe media objek.

Sintaks

HRESULT SetCurrentMediaType(
  [in] IMFMediaType *pMediaType
);

Parameter

[in] pMediaType

Penunjuk ke antarmuka IMFMediaType dari jenis media baru.

Menampilkan 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_INVALIDREQUEST
 Permintaan tidak valid.

Keterangan

Untuk sumber media, mengatur jenis media berarti sumber akan menghasilkan data yang sesuai dengan jenis media tersebut. Untuk sink media, mengatur jenis media berarti sink dapat menerima data yang sesuai dengan jenis media tersebut.

Setiap implementasi metode ini harus memeriksa apakah pMediaType berbeda dari jenis media objek saat ini. Jika jenisnya identik, metode harus mengembalikan S_OK tetapi menghindari melepaskan dan membuat ulang sumber daya yang tidak perlu. Jika jenisnya tidak identik, metode harus memvalidasi jenis baru.

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) diinstal.

Persyaratan

   
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