Skip to main content

​
XDspActivate

Activa una secuencia de XDSP mediante la adquisición de un recurso de procesamiento libre del grupo. Cada cliente de XDSP está limitado a 256 activaciones de secuencia.

​
Sintaxis

​
Parámetros

clientHandle   _In_
Tipo: XDspClientHandle Identificador de cliente de XDSP válido obtenido de la llamada a XDspConnect. params   _In_
Tipo: XDspActivationParameters* Puntero a una estructura XDspActivationParameters. status   _Outptr_
Tipo: XDspStatus** Puntero a una estructura XDspStatus. Consulte la sección Comentarios para obtener más detalles. streamHandle   _Outptr_
Tipo: XDspStreamHandle* XDspStreamHandle válido, si la llamada se realiza correctamente. Consulte la sección Comentarios para obtener más detalles.

​
Valor devuelto

Tipo: HRESULT Si el método se ejecuta correctamente, devuelve S_OK. Si el método falla, devuelve uno de los siguientes códigos (lista parcial):

​
Comentarios

Esta llamada es rápida porque adquiere los recursos del grupo en lugar de asignarlos. El autor de la llamada debe especificar un XDspProcessType para que lo ejecute la secuencia de XDSP. Una instancia de secuencia de XDSP solo puede trabajar con un tipo de procesamiento durante su ciclo de vida. Para ejecutar dos o más tipos de procesamiento diferentes, se deben crear dos o más instancias de secuencia de XDSP. Dentro de la estructura XDspActivationParameters, el autor de la llamada debe especificar lo siguiente:
  • Opciones de activación.
  • Número de fotogramas que se procesarán en cada comando, es decir, el número de fotogramas de entrada y de salida.
  • Número de canales de la secuencia. Solo se admiten secuencias de entrada mono y estéreo.
  • Para el tipo de procesamiento XDspProcessType::Convolution, la longitud de la respuesta al impulso en floats.
  • Para el tipo de procesamiento XDspProcessType::Convolution, la respuesta al impulso como valores en el dominio de la frecuencia.
Si la llamada se realiza correctamente, se devolverá un XDspStreamHandle válido para usarlo con otras llamadas (XDspSubmitCommand, XDspSubmitCommandWithEnvelope, XDspDeactivate) para esta secuencia. Además, si esta llamada se realiza correctamente, devolverá un puntero a XDspStatus que se puede usar para comprobar el estado de los comandos enviados. Esto debe usarse para determinar el último comando que se ha procesado y si los resultados de los comandos enviados están listos para consumirse. XDspStatus también contiene el número de secuencia del último comando que se envió al hardware y el número de secuencia del primer comando con error de la secuencia de XDSP que representa. En el caso del procesamiento de convolución, el autor de la llamada puede liberar la memoria de la respuesta al impulso después de que esta llamada devuelva el control.

​
Requisitos

Encabezado: XDspAudio.h Biblioteca: Chad.lib Plataformas compatibles: XBOX Series X|S

​
Documentación conceptual

​
Consulte también

XDSP
Errores de XDSP
Información general de una convolución de secuencia única mediante la API de XDSP
Información general de una FFT/IFFT de secuencia única mediante la API de XDSP
Información general de una convolución de secuencia única con envolvente mediante la API de XDSP
Última modificación el 28 de agosto de 2026

Temas relacionados

XDspDeactivateInformación general de XDSPInformación general de una convolución de secuencia única mediante la API XDSPConvolución de secuencia única con envolvente mediante la API XDSPAudio XDSP