IMFMediaType::Metode IsEqual (mfobjects.h)

Artikel
08/24/2023

Membandingkan dua jenis media dan menentukan apakah mereka identik. Jika tidak identik, metode menunjukkan bagaimana kedua format berbeda.

Sintaks

HRESULT IsEqual(
  [in]  IMFMediaType *pIMediaType,
  [out] DWORD        *pdwFlags
);

Parameter

[in] pIMediaType

Arahkan ke antarmuka IMFMediaType dari jenis media untuk dibandingkan.

[out] pdwFlags

Menerima bitwise OR dari nol atau lebih bendera, menunjukkan tingkat kesamaan antara dua jenis media. Bendera berikut ditentukan.

Nilai	Makna
MF_MEDIATYPE_EQUAL_MAJOR_TYPES 0x00000001	Jenis utamanya sama. Jenis utama ditentukan oleh atribut MF_MT_MAJOR_TYPE .
MF_MEDIATYPE_EQUAL_FORMAT_TYPES 0x00000002	Subjenisnya sama, atau tidak ada jenis media yang memiliki subjenis. Subjenis ditentukan oleh atribut MF_MT_SUBTYPE .
MF_MEDIATYPE_EQUAL_FORMAT_DATA 0x00000004	Atribut dalam salah satu jenis media adalah subset atribut di yang lain, dan nilai atribut ini cocok, tidak termasuk nilai atribut MF_MT_USER_DATA, MF_MT_FRAME_RATE_RANGE_MIN, dan MF_MT_FRAME_RATE_RANGE_MAX . Secara khusus, metode ini mengambil jenis media dengan jumlah atribut yang lebih kecil dan memeriksa apakah setiap atribut dari jenis tersebut ada dalam jenis media lain dan memiliki nilai yang sama (tidak termasuk MF_MT_USER_DATA, MF_MT_FRAME_RATE_RANGE_MIN, dan MF_MT_FRAME_RATE_RANGE_MAX). Untuk melakukan perbandingan lain, gunakan metode IMFAttributes::Compare . Misalnya, metode Bandingkan dapat menguji atribut yang identik, atau menguji persimpangan dua set atribut. Untuk informasi selengkapnya, lihat MF_ATTRIBUTES_MATCH_TYPE.
MF_MEDIATYPE_EQUAL_FORMAT_USER_DATA 0x00000008	Data pengguna identik, atau tidak ada jenis media yang berisi data pengguna. Data pengguna ditentukan oleh atribut MF_MT_USER_DATA .

Nilai kembali

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

Menampilkan kode	Deskripsi
S_FALSE	Jenisnya tidak sama. Periksa parameter pdwFlags untuk menentukan perbedaan jenisnya.
S_OK	Jenisnya sama.
E_INVALIDARG	Satu atau kedua jenis media tidak valid.

Keterangan

Kedua jenis media harus memiliki jenis utama, atau metode mengembalikan E_INVALIDARG.

Jika metode berhasil dan semua bendera perbandingan diatur dalam pdwFlags, nilai yang dikembalikan S_OK. Jika metode berhasil tetapi satu atau beberapa bendera perbandingan tidak diatur, metode mengembalikan S_FALSE.

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

IMFAttributes::Compare

IMFMediaType

Bagikan melalui