Metode IAudioMediaType::IsEqual (audiomediatype.h)

Artikel
02/23/2024

Metode ini IsEqual membandingkan dua jenis media dan menentukan apakah keduanya identik.

Sintaks

HRESULT IsEqual(
  [in]  IAudioMediaType *pIAudioType,
  [out] DWORD           *pdwFlags
);

Parameter

[in] pIAudioType

Menentukan penunjuk ke antarmuka IAudioMediaType dari jenis media untuk dibandingkan.

[out] pdwFlags

Menentukan penunjuk ke variabel DWORD yang berisi bitwise ATAU hasil nol atau lebih bendera. Bendera ini menunjukkan tingkat kesamaan antara dua jenis media. Tabel berikut ini memperlihatkan bendera yang didukung.

Bendera	Makna
AUDIOMEDIATYPE_EQUAL_FORMAT_TYPES	Jenis format audionya sama.
AUDIOMEDIATYPE_EQUAL_FORMAT_DATA	Informasi format cocok, tidak termasuk data tambahan di luar struktur WAVEFORMATEX dasar.
AUDIOMEDIATYPE_EQUAL_FORMAT_USER_DATA	Data tambahan identik, atau tidak ada jenis media yang berisi data tambahan.

Nilai kembali

Metode mengembalikan IsEqual S_OK jika berhasil, jika tidak, metode mengembalikan salah satu nilai HRESULT yang diperlihatkan dalam tabel berikut.

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

Keterangan

Kedua jenis media harus memiliki jenis utama, jika tidak, metode mengembalikan E_INVALIDARG. Untuk informasi selengkapnya tentang jenis media, lihat Jenis Media.

Bendera MF_MEDIATYPE_EQUAL_FORMAT_DATA menunjukkan bahwa kedua jenis media memiliki atribut yang kompatibel, meskipun mungkin merupakan superset dari yang lain. Metode perbandingan ini berarti Anda dapat membandingkan jenis media yang ditentukan sebagian dengan jenis media lengkap. Misalnya, Anda mungkin memiliki dua jenis video yang menjelaskan format yang sama, tetapi satu jenis menyertakan atribut untuk informasi warna yang diperluas (duduk klorma, rentang nominal, dan sebagainya).

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi Windows yang lebih baru.
Target Platform	Desktop
Header	audiomediatype.h (termasuk Audiomediatype.h)
IRQL	Semua tingkatan.

Lihat juga

IAudioMediaType

Jenis Media

WAVEFORMATEX

Bagikan melalui