> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/es/reference/audio/xapu/functions/xapuconnect.md).

*command*   \_In\_\
Tipo: [XApuCommandId\*](https://docs.xbox.com/es/reference/audio/xapu/structs/xapucommandid.md)

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

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

| XApuCommandType | Tipo de estructura |
| - | - |
| XApuCommandType::Activate | [XApuDecodeConvertActivateCommand](https://docs.xbox.com/es/reference/audio/xapu/structs/xapudecodeconvertactivatecommand.md) |
| XApuCommandType::Deactivate | [XApuCommandId](https://docs.xbox.com/es/reference/audio/xapu/structs/xapucommandid.md) |
| XApuCommandType::Process | [XApuDecodeConvertCommand](https://docs.xbox.com/es/reference/audio/xapu/structs/xapudecodeconvertcommand.md) |
| XApuCommandType::Notify | [XApuCommandId](https://docs.xbox.com/es/reference/audio/xapu/structs/xapucommandid.md) |
| XApuCommandType::Reset | [XApuCommandId](https://docs.xbox.com/es/reference/audio/xapu/structs/xapucommandid.md) |

## Requisitos

**Encabezado:** xapu.h

**Biblioteca:** xapu.lib

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

## Consulte también

[XAPU](https://docs.xbox.com/es/reference/audio/xapu/xapu_members.md)


## Related topics

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