Método IXAPO::LockForProcess (xapo.h)
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 |