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

# XWMAEncoder

> XWMAEncoder

Codifica um buffer de entrada em dados xWMA.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT XWMAEncoder(
         const BYTE *pInputBuffer,
         DWORD inputBufferSize,
         const WAVEFORMATEX *pInputFormat,
         DWORD outputBitrate,
         BYTE **ppEncodedBuffer,
         DWORD *pEncodedBufferSize,
         WAVEFORMATEX **ppEncodedBufferFormat,
         DWORD *pEncodedBufferFormatSize,
         DWORD **ppDecodedPacketCumulativeBytes,
         DWORD *pDecodedPacketCumulativeBytesSize)  
```

<a id="ID4EG" />

### Parâmetros

*pInputBuffer*
Tipo: BYTE \*

Ponteiro para o buffer de entrada que contém dados PCM; deve conter pelo menos um quadro.

*inputBufferSize*
Tipo: DWORD

Tamanho do buffer de entrada, em bytes.

*pInputFormat*
Tipo: WAVEFORMATEX \*

Formato do buffer de entrada.

*outputBitrate*
Tipo: DWORD

Especifica a taxa de bits solicitada; deve ser 20000, 32000, 48000, 64000, 96000, 160000 ou 192000.

*ppEncodedBuffer*
Tipo: BYTE \*\*

Ponteiro para um ponteiro para os dados codificados.

*pEncodedBufferSize*
Tipo: DWORD \*

Ponteiro para um DWORD que contém o tamanho dos dados codificados, em bytes.

*ppEncodedBufferFormat*
Tipo: WAVEFORMATEX \*\*

Ponteiro para um ponteiro para a estrutura de formato de saída.

*pEncodedBufferFormatSize*
Tipo: DWORD \*

Ponteiro para um DWORD que contém o tamanho da estrutura de formato de saída.

*ppDecodedPacketCumulativeBytes*
Tipo: DWORD \*\*

Matriz de tamanho cumulativo de dados de pacotes decodificados (use free \[] para liberar). Cada elemento é o número de bytes acumulados quando o pacote WMA correspondente é decodificado em ordem; deve ter PacketCount elementos. PacketCount é definido na estrutura XAUDIO2\_BUFFER\_WMA.

*pDecodedPacketCumulativeBytesSize*
Tipo: DWORD \*

Tamanho dos dados cumulativos de pacotes decodificados (em bytes). O número de pacotes = \*pDecodedPacketCumulativeBytesSize / sizeof(DWORD);

<a id="ID4EO" />

### Valor retornado

Tipo: HRESULT

Retorna S\_OK se for bem-sucedido; caso contrário, retorna um código de erro da tabela a seguir.

| Código de erro | Descrição |
| - | - |
| XWMA\_E\_UNSUPPORTED\_FORMATTAG | A marca de formato deve ser WAVE\_FORMAT\_PCM ou WAVE\_FORMAT\_IEEE\_FLOAT. |
| XWMA\_E\_UNSUPPORTED\_FRAMERATE | nSamplesPerSec deve estar entre 1 kHz e 200 kHz. |
| XWMA\_E\_UNSUPPORTED\_CHANNELS | nChannels deve ser 1, 2 ou 6. |
| XWMA\_E\_UNSUPPORTED\_BITSPERSAMPLE | wBitsPerSample deve ser 8, 16 ou 24 para dados de entrada inteiros ou 32 para dados de ponto flutuante. |
| XWMA\_E\_UNSUPPORTED\_BITRATE | A taxa de bits deve ser 20 Kbps, 32 Kbps, 48 Kbps, 64 Kbps, 96 Kbps, 16 Kbps0 ou 192 Kbps. |

<a id="remarks" />

## Comentários

A tabela a seguir mostra as taxas de bits compatíveis nativamente por taxa de amostragem e contagem de canais.

\| Entrada| Opções de saída|
\| --- | --- | --- | --- |
\| 22050 Hz mono| 20000|
\| 22050 Hz estéreo| 32000|
\| 32000 Hz mono| 20000|
\| 32000 Hz estéreo| 32000, 48000|
\| 44100 Hz mono| 32000, 48000|
\| 44100 Hz estéreo| 32000, 48000, 96000, 192000|
\| 44100 Hz 5.1| 96000, 192000|
\| 48000 Hz estéreo| 48000, 64000, 96000, 160000, 192000|
\| 48000 Hz 5.1| 48000, 192000|

<a id="requirements" />

## Requisitos

**Cabeçalho:** xwmaencoder.h

**Biblioteca:** xwmaencoder.lib

## Confira também

[Codificador de linha de comando xWMA](/pt-BR/build/console-features/audio/tools/xwmaencode-tools)


## Related topics

- [Funções do Xwmaencoder](/pt-BR/build/console-features/audio/tools/xwmaencoder/tech-xwmaencoder-nativereference-funcs.md)
- [Visão geral do xWMA](/pt-BR/build/console-features/audio/overviews/xwma-overview.md)
- [Informações de referência do codificador xWMA](/pt-BR/build/console-features/audio/tools/xwmaencoder/atoc-xwmaencoder.md)
- [Biblioteca de codificação xWMA e ferramenta de linha de comando](/pt-BR/build/console-features/audio/tools/xwmaencoder/index.md)
- [Biblioteca de codificação XMA2 e ferramenta de linha de comando](/pt-BR/build/console-features/audio/tools/xma2encoder/index.md)