Метод IAudioProcessingObjectConfiguration::LockForProcess (audioenginebaseapo.h)

Метод LockForProcess используется для проверки блокировки APO и готовности к обработке данных.

Синтаксис

HRESULT LockForProcess(
  [in] UINT32                    u32NumInputConnections,
  [in] APO_CONNECTION_DESCRIPTOR **ppInputConnections,
  [in] UINT32                    u32NumOutputConnections,
  [in] APO_CONNECTION_DESCRIPTOR **ppOutputConnections
);

Параметры

[in] u32NumInputConnections

Количество входных подключений, подключенных к этому объекту APO.

[in] ppInputConnections

Дескриптор подключения для каждого входного подключения, подключенного к этому APO.

[in] u32NumOutputConnections

Количество выходных подключений, подключенных к этому объекту APO.

[in] ppOutputConnections

Дескриптор подключения для каждого выходного подключения, подключенного к этому APO.

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

Метод LockForProcess возвращает значение S_OK, если вызов успешно завершен. На этом этапе APO заблокирован и готов к обработке данных.

Код возврата Описание
E_POINTER
В функцию передан недопустимый указатель.
APOERR_INVALID_CONNECITON_FORMAT
Недопустимый формат подключения.
APOERR_NUM_CONNECTIONS_INVALID
Количество входных или выходных подключений, недопустимое для этого объекта APO.
APOERR_APO_LOCKED
APO уже заблокирован.
Другие HRESULTS
Эти сбои будут отслеживаться подсистемой аудиоданных.

Комментарии

При вызове LockForProcess метода сначала выполняется внутреннее проверка, чтобы проверить, инициализирован ли объект APO и готов к обработке данных. Каждый объект APO имеет разные требования к инициализации, поэтому при необходимости каждый APO должен определить собственный метод инициализации.

Требования

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