Skip to main content

​
XApuConnect

Establece una conexión y asigna los recursos necesarios para una unidad de procesamiento de audio (XAPU).

​
Sintaxis

​
Parámetros

params   _In_
Tipo: XApuConnectInputParameters* Parámetros que se pasan a XApuConnect para los recursos asignados. data   _Out_
Tipo: XApuConnectOutputParameters* Parámetros devueltos por XApuConnect. handle   _Outptr_
Tipo: XApuHandle* Puntero a un identificador de XAPU devuelto. Este identificador se usa para indicar qué instancia de XAPU se debe manipular al llamar a otras API de XAPU.

​
Valor devuelto

Tipo: HRESULT Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve un código de error.

​
Comentarios

El autor de la llamada debe especificar un XApuProcessType que ejecutará el cliente de XAPU. Una instancia de XAPU puede trabajar con un tipo de proceso durante su vigencia. Para realizar dos o más procesos diferentes, se deben crear dos o más instancias de XAPU. Dentro de XApuConnectInputParameters, el autor de la llamada debe especificar lo siguiente:
  • Número máximo de secuencias que se espera que XAPU procese simultáneamente.
  • Número máximo de comandos en cola para cada secuencia.
  • Asignación de memoria total necesaria para todos los comandos y secuencias. Esto incluye las asignaciones totales para los datos de entrada, salida y procesamiento en el número máximo de secuencias multiplicado por los comandos en cola por secuencia.
Si la llamada se ejecuta correctamente, el parámetro XApuConnectOutputParameters::baseData apuntará a un fragmento de memoria que el autor de la llamada debe usar para pasar los datos de entrada y recuperar los datos de salida de las secuencias. Corresponde al autor de la llamada particionar y reciclar este fragmento de memoria. La asignación se liberará al llamar a XApuDisconnect. XApuConnectOutputParameters::resultReadyEvent contendrá un identificador de evento Win32 cuando se establezca XApuConnectOptions::EnableResultReadyEvent. Este identificador se cerrará al llamar a XApuDisconnect. Este identificador se cerrará al llamar a XApuDisconnect. No se recomienda llamar a XapuConnect y XApuDisconnect con frecuencia para iniciar y detener secuencias, ya que esas llamadas consumen mucho tiempo y también podrían provocar pérdidas de recursos debido a la fragmentación de la memoria. En su lugar, se debe llamar a XapuConnect una vez al inicializar la sesión de transmisión y, a continuación, usar XApuCommandType::Activate y XApuCommandType::Deactivate para iniciar y detener secuencias durante la transmisión. Al final de la sesión de transmisión, se debe llamar a XApuDisconnect. Esto se aplica a todos los clientes de XAPU.

​
Requisitos

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

​
Documentación conceptual

​
Consulte también

XAPU
XApuDecodeConvertCommand
XApuDequeueResult
XApuEnqueueCommand
XApuGetResultCount
Última modificación el 28 de agosto de 2026

Temas relacionados

XApuConnectOutputParametersXApuConnectOptionsXApuConnectInputParametersXApuDisconnectXApuDequeueResult