METODE IMFMediaType::GetRepresentation (mfobjects.h)

  • Artikel

Mengambil representasi alternatif dari jenis media. Saat ini hanya struktur AM_MEDIA_TYPE DirectShow yang didukung.

Sintaks

HRESULT GetRepresentation(
  [in]  GUID   guidRepresentation,
  [out] LPVOID *ppvRepresentation
);

Parameter

[in] guidRepresentation

GUID yang menentukan representasi yang akan diambil. Nilai berikut didefinisikan.

Nilai Makna
AM_MEDIA_TYPE_REPRESENTATION
 Mengonversi jenis media menjadi struktur AM_MEDIA_TYPE DirectShow. Metode memilih struktur format yang paling tepat (pbFormat).
FORMAT_MFVideoFormat
 Konversi jenis media menjadi struktur AM_MEDIA_TYPE DirectShow dengan struktur format MFVIDEOFORMAT .
FORMAT_VideoInfo
 Konversi jenis media menjadi struktur AM_MEDIA_TYPE DirectShow dengan struktur format VIDEOINFOHEADER .
FORMAT_VideoInfo2
 Konversikan jenis media menjadi struktur AM_MEDIA_TYPE DirectShow dengan struktur format VIDEOINFOHEADER2 .

[out] ppvRepresentation

Menerima penunjuk ke struktur yang berisi representasi. Metode mengalokasikan memori untuk struktur. Pemanggil harus melepaskan memori dengan memanggil IMFMediaType::FreeRepresentation.

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_ATTRIBUTENOTFOUND
 Detail jenis media tidak cocok dengan representasi yang diminta.
MF_E_INVALIDMEDIATYPE
 Tipe media tidak valid.
MF_E_UNSUPPORTED_REPRESENTATION
 Tipe media tidak mendukung representasi yang diminta.

Keterangan

Jika Anda meminta struktur format tertentu dalam parameter guidRepresentation , seperti VIDEOINFOHEADER, Anda mungkin kehilangan beberapa informasi format.

Anda juga dapat menggunakan fungsi MFInitAMMediaTypeFromMFMediaType untuk mengonversi jenis media Media Foundation menjadi jenis media DirectShow.

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.

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 mfobjects.h (termasuk Mfidl.h)
Pustaka Mfuuid.lib

Lihat juga

IMFMediaType

MFVIDEOFORMAT

Jenis Media