Skip to main content

​
XApuEnqueueCommand

Envia um único comando para a fila de comandos do XAPU.

​
Sintaxe

​
Parâmetros

handle   _In_
Tipo: XApuHandle Identificador retornado pela chamada de XApuConnect. command   _In_
Tipo: XApuCommandId* Comando a ser enviado para a fila de entrada do XAPU. totalCommandCount   _Out_opt_
Tipo: uint32_t* Contagem total de comandos, retornada.

​
Valor retornado

Tipo: HRESULT Retornará S_OK se tiver êxito; caso contrário, retornará um código de erro.

​
Comentários

Essa chamada é rápida, pois não aloca recursos nem processa dados; ela apenas envia o comando ao servidor de hardware. Essa chamada retornará XAPU_E_QUEUE_FULL se houver XApuConnectInputParameters::maxQueuedCommandsPerStream comandos em processamento. Para evitar esse erro, o chamador deve recuperar um ou mais resultados por meio de XApuDequeueResult. Essa chamada é thread-safe, ou seja, é possível enviar comandos de vários threads; no entanto, não há vantagem de desempenho em chamá-la de mais de um thread. Essa chamada também recebe um ponteiro para uint32_t para retornar o totalCommandCount da sessão atual. Esse número representa o total de comandos que foram enviados com êxito desde o início da sessão e após a chamada de XApuConnect. Esse número não volta a zero. Se o servidor de hardware estiver em um estado inválido, XApuEnqueueCommand retornará o código de erro XAPU_E_DEVICE_FATAL_ERROR. Nesse caso, todos os clientes XAPU devem ser desconectados e reconectados. Se esse método falhar, um código de erro descritivo será retornado. A tabela a seguir mapeia cada XApuCommandType para o tipo de struct que deve ser passado para XApuEnqueueCommand:

​
Requisitos

Cabeçalho: xapu.h Biblioteca: xapu.lib Plataformas compatíveis: XBOX Series X|S

​
Confira também

XAPU
Last modified on October 6, 2026