Método IXAPO::LockForProcess (xapo.h)

  • Artículo

XAudio2 llama a para bloquear las configuraciones de entrada y salida de un XAPO, lo que le permite realizar cualquier inicialización final antes de llamar al proceso en el subproceso en tiempo real.

Sintaxis

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

Parámetros

InputLockedParameterCount

Número de elementos de ppInputLockedParameters. Debe estar dentro del XAPO_REGISTRATION_PROPERTIES. MinInputBufferCount y XAPO_REGISTRATION_PROPERTIES. Valores MaxInputBufferCount pasados a CXAPOBase::CXAPOBase.

pInputLockedParameters

Matriz de estructuras de XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS de entrada. pInputLockedParameters puede ser NULL si InputLockedParameterCount es 0; de lo contrario, debe tener elementos InputLockedParameterCount .

OutputLockedParameterCount

Número de elementos de ppOutputLockedParameters. Debe estar dentro del XAPO_REGISTRATION_PROPERTIES. MinOutputBufferCount y XAPO_REGISTRATION_PROPERTIES. Valores MaxOutputBufferCount pasados a CXAPOBase::CXAPOBase. Si se especificó la marca XAPO_FLAG_BUFFERCOUNT_MUST_MATCH en XAPO_REGISTRATION_PROPERTIES. A continuación, las marcas OutputLockedParameterCount deben ser iguales a InputLockedParameterCount.

pOutputLockedParameters

Matriz de estructuras de XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS de salida. pOutputLockedParameters puede ser NULL si OutputLockedParameterCount es 0; de lo contrario, debe tener elementos OutputLockedParameterCount .

Valor devuelto

Devuelve S_OK si se ejecuta correctamente, de lo contrario, un código de error.

Observaciones

Una vez bloqueado, la configuración de entrada y salida y los demás parámetros bloqueados permanecen constantes hasta que se llama a UnLockForProcess . Una vez bloqueado un XAPO, las llamadas adicionales a LockForProcess no tienen ningún efecto hasta que se llama a la función UnLockForProcess .

Un XAPO indica qué formatos específicos admite a través de su implementación de los métodos IsInputFormatSupported e IsOutputFormatSupported . Un XAPO debe afirmar que se admiten las configuraciones de entrada y salida y que se completa cualquier inicialización específica del efecto necesaria. Los métodos IsInputFormatSupported, IsOutputFormatSupported e Initialize deben usarse según sea necesario antes de llamar a este método.

Dado que Process es un método de no bloqueo, todos los búferes de memoria internos necesarios para Process deben asignarse en LockForProcess.

Nunca se llama al proceso antes de que LockForProcess se devuelva correctamente.

XAudio2 llama directamente a LockForProcess y no debe llamarlo el código de cliente.

Requisitos de la plataforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK de DirectX (XAudio 2.7)

Requisitos

   
Plataforma de destino Windows
Encabezado xapo.h

Consulte también

IXAPO