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

Метод IAudioProcessingObject::IsOutputFormatSupported (audioenginebaseapo.h)

  • Статья

Метод IsOutputFormatSupported используется для проверки поддержки определенного формата вывода.

Синтаксис

HRESULT IsOutputFormatSupported(
  [in, optional]  IAudioMediaType *pOppositeFormat,
  [in, optional]  IAudioMediaType *pRequestedOutputFormat,
  [out, optional] IAudioMediaType **ppSupportedOutputFormat
);

Параметры

[in, optional] pOppositeFormat

Указатель на интерфейс IAudioMediaType. Этот параметр указывает формат вывода. Этот параметр должен иметь значение NULL , чтобы указать, что выходной формат может быть любого типа.

[in, optional] pRequestedOutputFormat

Указатель на интерфейс IAudioMediaType . Этот параметр указывает формат выходных данных, который требуется проверить.

[out, optional] ppSupportedOutputFormat

Этот параметр указывает поддерживаемый формат выходных данных, который ближе всего к формату для проверки.

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

Если вызов завершается успешно, параметр ppSupportedOutputFormat возвращает указатель pRequestedOutputFormat, а метод IsOutputFormatSupported возвращает значение S_OK. В противном случае этот метод возвращает один из следующих кодов ошибок:

Код возврата Описание
S_FALSE
 Формат пары форматов входных и выходных данных не поддерживается. Параметр ppSupportedOutPutFormat возвращает предлагаемый новый формат.
APOERR_FORMAT_NOT_SUPPORTED
 Формат не поддерживается. Значение ppSupportedOutputFormat не изменяется.
E_POINTER
 В функцию передан недопустимый указатель. Значение ppSupportedOutputFormat не изменяется.
Другие значения HRESULT
 Эти дополнительные условия ошибок отслеживаются обработчиком звука.

Комментарии

Существуют различия в реализации IsOutputFormatSupported метода различными API. Например, в некоторых реализациях выходные данные могут иметь тип float, только если входной формат имеет целое число типа.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционной системы Windows.
Целевая платформа Универсальное
Верхняя часть audioenginebaseapo.h
Библиотека Audioenginebaseapo.idl
IRQL Все уровни

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

IAudioMediaType

IAudioProcessingObject