Поделиться через

Метод IAudioMediaType::IsEqual (audiomediatype.h)

  • Статья

Метод IsEqual сравнивает два типа мультимедиа и определяет, идентичны ли они.

Синтаксис

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

Параметры

[in] pIAudioType

Указывает указатель на интерфейс IAudioMediaType сравниваемого типа мультимедиа.

[out] pdwFlags

Указывает указатель на переменную DWORD, содержащую побитовый результат OR нулевого или более флагов. Эти флаги указывают степень сходства между двумя типами носителей. В следующей таблице показаны поддерживаемые флаги.

Flag Значение
AUDIOMEDIATYPE_EQUAL_FORMAT_TYPES Типы аудиоформатов одинаковы.
AUDIOMEDIATYPE_EQUAL_FORMAT_DATA Сведения о формате совпадают, не включая дополнительные данные за пределами базовой структуры WAVEFORMATEX .
AUDIOMEDIATYPE_EQUAL_FORMAT_USER_DATA Дополнительные данные идентичны, либо ни тип носителя не содержит дополнительных данных.

Возвращаемое значение

Метод IsEqual возвращает S_OK в случае успешного выполнения, в противном случае возвращает одно из значений HRESULT, показанных в следующей таблице.

Код возврата Описание
E_INVALIDARG
 Один тип мультимедиа недопустим или оба типа мультимедиа недопустимы.
S_FALSE
 Типы мультимедиа не равны. Изучите параметр pdwFlags, чтобы определить, чем отличаются типы носителей.

Комментарии

Оба типа мультимедиа должны иметь основной тип, в противном случае метод возвращает E_INVALIDARG. Дополнительные сведения о типах мультимедиа см. в разделе Типы носителей.

Флаг MF_MEDIATYPE_EQUAL_FORMAT_DATA указывает, что оба типа мультимедиа имеют совместимые атрибуты, хотя один из них может быть надмножеством другого. Этот метод сравнения означает, что можно сравнить частично указанный тип мультимедиа с полным типом мультимедиа. Например, у вас может быть два типа видео, которые описывают один и тот же формат, но один тип включает атрибуты для расширенных сведений о цвете (chroma siting, номинальный диапазон и т. д.).

Если метод выполнен успешно и все флаги сравнения заданы в pdwFlags, возвращаемое значение будет S_OK. Если метод выполнен успешно, но некоторые флаги сравнения не заданы, метод возвращает S_FALSE.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть audiomediatype.h (включая Audiomediatype.h)
IRQL Все уровни.

См. также раздел

IAudioMediaType

Типы носителей

WAVEFORMATEX