> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # XDspActivate > XDspActivate # 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 ```cpp theme={null} HRESULT XDspActivate( XDspClientHandle clientHandle, XDspActivationParameters* params, XDspStatus** status, XDspStreamHandle* streamHandle ) ``` ### Parámetros *clientHandle*   \_In\_\ Tipo: [XDspClientHandle](/reference/audio/xdspaudio/handles/xdspclienthandle) Identificador de cliente de XDSP válido obtenido de la llamada a XDspConnect. *params*   \_In\_\ Tipo: [XDspActivationParameters\*](/reference/audio/xdspaudio/structs/xdspactivationparameters) Puntero a una estructura [XDspActivationParameters](/reference/audio/xdspaudio/structs/xdspactivationparameters). *status*   \_Outptr\_\ Tipo: [XDspStatus\*\*](/reference/audio/xdspaudio/structs/xdspstatus) Puntero a una estructura [XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus). Consulte la sección **Comentarios** para obtener más detalles. *streamHandle*   \_Outptr\_\ Tipo: [XDspStreamHandle\*](/reference/audio/xdspaudio/handles/xdspstreamhandle) [XDspStreamHandle](/reference/audio/xdspaudio/handles/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): | Código devuelto | Descripción | | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | E\_POINTER | Puntero que no es válido. | | E\_INVALIDARG | Uno o varios de los argumentos no son válidos. | | XDSP\_E\_NO\_DEVICE\_RESOURCES | No hay recursos de dispositivo XDSP disponibles para atender su solicitud. | | XDSP\_E\_INVALID\_IMPULSE\_RESPONSE\_LENGTH | La longitud de respuesta al impulso proporcionada no es válida. Este error puede producirse si se proporciona un valor de [impulseResponseLengthInFloats](/reference/audio/xdspaudio/structs/xdspactivationparameters) inferior a (`9 * blockSize * 2`) o superior a 16 segundos (`16 * 48000 * 2`). | ## 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](/reference/audio/xdspaudio/enums/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](/reference/audio/xdspaudio/structs/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](/reference/audio/xdspaudio/enums/xdspprocesstype), la longitud de la respuesta al impulso en floats. * Para el tipo de procesamiento [XDspProcessType::Convolution](/reference/audio/xdspaudio/enums/xdspprocesstype), la respuesta al impulso como valores en el dominio de la frecuencia. Si la llamada se realiza correctamente, se devolverá un [XDspStreamHandle](/reference/audio/xdspaudio/handles/xdspstreamhandle) válido para usarlo con otras llamadas ([XDspSubmitCommand](/reference/audio/xdspaudio/functions/xdspsubmitcommand), [XDspSubmitCommandWithEnvelope](/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope), [XDspDeactivate](/reference/audio/xdspaudio/functions/xdspdeactivate)) para esta secuencia. Además, si esta llamada se realiza correctamente, devolverá un puntero a [XDspStatus](/reference/audio/xdspaudio/structs/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](/reference/audio/xdspaudio/structs/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 * [Información general de una convolución de secuencia única con envolvente mediante la API de XDSP](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope) * [Información general de una convolución de secuencia única mediante la API de XDSP](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution) * [Información general de XDSP](/build/console-features/audio/overviews/xdsp-overview) ## Consulte también [XDSP](/reference/audio/xdspaudio/xdspaudio_members)\ [Errores de XDSP](/reference/audio/xdspaudio/enums/xdsperrors)\ [Información general de una convolución de secuencia única mediante la API de XDSP](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\ [Información general de una FFT/IFFT de secuencia única mediante la API de XDSP](/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)\ [Información general de una convolución de secuencia única con envolvente mediante la API de XDSP](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope) ## Related topics - [XDspDeactivate](/es/reference/audio/xdspaudio/functions/xdspdeactivate.md) - [Información general de XDSP](/es/build/console-features/audio/overviews/xdsp-overview.md) - [Información general de una convolución de secuencia única mediante la API XDSP](/es/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md) - [Convolución de secuencia única con envolvente mediante la API XDSP](/es/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md) - [Audio XDSP](/es/reference/audio/xdspaudio/xdspaudio_members.md)