IMFMediaType::Metode IsEqual (mfobjects.h)

  • Artikel

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