Метод IApoAuxiliaryInputConfiguration::IsInputFormatSupported (audioenginebaseapo.h)

Проверяет, поддерживается ли APO определенный вспомогательный формат входных данных.

Синтаксис

HRESULT IsInputFormatSupported(
  IAudioMediaType *pRequestedInputFormat,
  IAudioMediaType **ppSupportedInputFormat
);

Параметры

pRequestedInputFormat

Формат входных данных, который требуется проверить.

ppSupportedInputFormat

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

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

HRESULT

Комментарии

Если APO может принять запрошенный формат, он должен добавить ссылку на запрошенный формат, вернуть его в качестве поддерживаемого выходного формата и вернуть S_OK.

Если APO не может принять запрошенный формат, он может предложить альтернативный запрошенный формат. В этом случае он должен создать и вернуть предлагаемый формат, а также вернуть S_FALSE.

Возвращаемый поддерживаемый формат должен быть "ближе всего" к запрошенному формату, то есть формат должен иметь одинаковые значения для следующих свойств, указанных в порядке приоритета.

• Пример формата
• битовая глубина
• количество каналов
• частота выборки

Предлагаемый формат может отличаться от запрошенного только в том случае, если возвращается S_FALSE. При возврате любого сбоя предлагаемый формат следует оставить нетронутым.

Этот API можно вызвать в любое время. Возвращаемые результаты будут зависеть от внутреннего состояния APO, которыми могут управлять внешние пользовательские интерфейсы. Однако после блокировки APO для обработки этот формат не может и не изменится.

Этот метод не может вызываться из потока обработки в режиме реального времени.

Требования