Метод IXAPO::LockForProcess (xapo.h)

Статья
08/28/2023

Вызывается методом XAudio2 для блокировки конфигураций входных и выходных данных XAPO, что позволяет выполнять любую окончательную инициализацию перед вызовом process в потоке в реальном времени.

Синтаксис

HRESULT LockForProcess(
  UINT32                               InputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pInputLockedParameters,
  UINT32                               OutputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pOutputLockedParameters
);

Параметры

InputLockedParameterCount

Количество элементов в ppInputLockedParameters. Должен находиться в XAPO_REGISTRATION_PROPERTIES. MinInputBufferCount и XAPO_REGISTRATION_PROPERTIES. Значения MaxInputBufferCount, передаваемые в CXAPOBase::CXAPOBase.

pInputLockedParameters

Массив входных XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS структур. pInputLockedParameters может иметь значение NULL, если inputLockedParameterCount имеет значение 0, в противном случае он должен иметь элементы InputLockedParameterCount .

OutputLockedParameterCount

Количество элементов в ppOutputLockedParameters. Должен находиться в XAPO_REGISTRATION_PROPERTIES. MinOutputBufferCount и XAPO_REGISTRATION_PROPERTIES. Значения MaxOutputBufferCount, передаваемые в CXAPOBase::CXAPOBase. Если флаг XAPO_FLAG_BUFFERCOUNT_MUST_MATCH был указан в XAPO_REGISTRATION_PROPERTIES. Флаги, а затем OutputLockedParameterCount должны иметь значение InputLockedParameterCount.

pOutputLockedParameters

Массив выходных XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS структур. POutputLockedParameters может иметь значение NULL, если OutputLockedParameterCount имеет значение 0, в противном случае он должен иметь элементы OutputLockedParameterCount .

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

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

После блокировки конфигурация входных и выходных данных и любые другие заблокированные параметры остаются постоянными до вызова UnLockForProcess . После блокировки XAPO дальнейшие вызовы LockForProcess не будут действовать, пока не будет вызвана функция UnLockForProcess .

XAPO указывает, какие форматы поддерживаются с помощью реализации методов IsInputFormatSupported и IsOutputFormatSupported . XAPO должен утверждать, что конфигурации входных и выходных данных поддерживаются и что любая требуемая инициализация для конкретного эффекта завершена. Перед вызовом этого метода следует использовать методы IsInputFormatSupported, IsOutputFormatSupported и Initialize .

Так как Process является неблокирующим методом, все внутренние буферы памяти, необходимые для Process , должны быть выделены в LockForProcess.

Процесс никогда не вызывается до успешного возврата LockForProcess .

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

Требования к платформе

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); Пакет SDK для DirectX (XAudio 2.7)

Требования


Целевая платформа	Windows
Header	xapo.h

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

IXAPO