Skip to main content

​
XApuEnqueueCommand

Envía un único comando a la cola de comandos de XAPU.

​
Sintaxis

​
Parámetros

handle   _In_
Tipo: XApuHandle Identificador devuelto al llamar a XApuConnect. command   _In_
Tipo: XApuCommandId* Comando que se enviará a la cola de entrada de XAPU. totalCommandCount   _Out_opt_
Tipo: uint32_t* Recuento total de comandos, devuelto.

​
Valor devuelto

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

​
Comentarios

Esta llamada será rápida, ya que no asignará recursos ni procesará datos, y solo envía el comando al servidor de hardware. Esta llamada devolverá XAPU_E_QUEUE_FULL si hay XApuConnectInputParameters::maxQueuedCommandsPerStream comandos en procesamiento. Para evitar este error, el autor de la llamada debe recuperar uno o varios resultados mediante XApuDequeueResult. Esta llamada es segura para subprocesos, es decir, es posible enviar comandos desde varios subprocesos; sin embargo, no hay ninguna ventaja de rendimiento en llamarla desde más de un subproceso. Esta llamada también tomará un puntero a uint32_t para devolver el valor de totalCommandCount de la sesión actual. Este número representa el total de comandos que se han enviado correctamente desde que se inició la sesión y después de llamar a XApuConnect. Este número no volverá a cero. Si el servidor de hardware está en mal estado, XApuEnqueueCommand devolverá el código de error XAPU_E_DEVICE_FATAL_ERROR. En este caso, todos los clientes de XAPU deben desconectarse y volver a conectarse. Si este método falla, se devolverá un código de error descriptivo. La tabla siguiente asigna cada XApuCommandType al tipo de estructura que se debe pasar a XApuEnqueueCommand:

​
Requisitos

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

​
Consulte también

XAPU
Última modificación el 28 de agosto de 2026

Temas relacionados

XApuCommandTypeXApuDecodeConvertCommandXApuDecodeConvertActivateCommandXApuConnectXApuDequeueResult