> ## 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.

# XApuEnqueueCommand

> XApuEnqueueCommand

# XApuEnqueueCommand

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

## Sintaxis

```cpp theme={null}
HRESULT XApuEnqueueCommand(  
         XApuHandle handle,  
         XApuCommandId* command,  
         uint32_t* totalCommandCount  
)  
```

### Parámetros

*handle*   \_In\_\
Tipo: XApuHandle

Identificador devuelto al llamar a [XApuConnect](/reference/audio/xapu/functions/xapuconnect).

*command*   \_In\_\
Tipo: [XApuCommandId\*](/reference/audio/xapu/structs/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](/reference/audio/xapu/enums/xapuerrors) si hay [XApuConnectInputParameters::maxQueuedCommandsPerStream](/reference/audio/xapu/structs/xapuconnectinputparameters) comandos en procesamiento. Para evitar este error, el autor de la llamada debe recuperar uno o varios resultados mediante [XApuDequeueResult](/reference/audio/xapu/functions/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](/reference/audio/xapu/functions/xapuconnect). Este número no volverá a cero.

Si el servidor de hardware está en mal estado, [XApuEnqueueCommand](/reference/audio/xapu/functions/xapuenqueuecommand) devolverá el código de error [XAPU\_E\_DEVICE\_FATAL\_ERROR](/reference/audio/xapu/enums/xapuerrors). 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](/reference/audio/xapu/enums/xapucommandtype) al tipo de estructura que se debe pasar a **XApuEnqueueCommand**:

| XApuCommandType             | Tipo de estructura                                                                                 |
| --------------------------- | -------------------------------------------------------------------------------------------------- |
| XApuCommandType::Activate   | [XApuDecodeConvertActivateCommand](/reference/audio/xapu/structs/xapudecodeconvertactivatecommand) |
| XApuCommandType::Deactivate | [XApuCommandId](/reference/audio/xapu/structs/xapucommandid)                                       |
| XApuCommandType::Process    | [XApuDecodeConvertCommand](/reference/audio/xapu/structs/xapudecodeconvertcommand)                 |
| XApuCommandType::Notify     | [XApuCommandId](/reference/audio/xapu/structs/xapucommandid)                                       |
| XApuCommandType::Reset      | [XApuCommandId](/reference/audio/xapu/structs/xapucommandid)                                       |

## Requisitos

**Encabezado:** xapu.h

**Biblioteca:** xapu.lib

**Plataformas compatibles:** XBOX Series X|S

## Consulte también

[XAPU](/reference/audio/xapu/xapu_members)


## Related topics

- [XApuCommandType](/es/reference/audio/xapu/enums/xapucommandtype.md)
- [XApuDecodeConvertCommand](/es/reference/audio/xapu/structs/xapudecodeconvertcommand.md)
- [XApuDecodeConvertActivateCommand](/es/reference/audio/xapu/structs/xapudecodeconvertactivatecommand.md)
- [XApuConnect](/es/reference/audio/xapu/functions/xapuconnect.md)
- [XApuDequeueResult](/es/reference/audio/xapu/functions/xapudequeueresult.md)