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

# XAudio2XMAEncoder

> XAudio2XMAEncoder

Codifica os fluxos de entrada no formato XMA.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT XAudio2XMAEncoder(
         DWORD InputStreamCount,
         const XMAENCODERSTREAM *pStreams,
         DWORD Compression,
         DWORD Flags,
         DWORD BlockSizeInKbytes,
         VOID **ppEncodedBuffer,
         DWORD *pEncodedBufferSize,
         XMA2WAVEFORMATEX **ppEncodedBufferFormat,
         DWORD *pEncodedBufferFormatSize,
         DWORD **ppSeekTable,
         DWORD *pSeekTableSize)  
```

<a id="ID4EG" />

### Parâmetros

*InputStreamCount*
Tipo: DWORD

Número de fluxos de entrada.

*pStreams*
Tipo: XMAENCODERSTREAM \*

Ponteiro para os fluxos de entrada.

*Compression*
Tipo: DWORD

Nível de qualidade de compactação XMA2 a ser usado (1 a 100).

*Flags*
Tipo: DWORD

Zero, ou um ou mais dos sinalizadores a seguir.

| Sinalizador | Valor | Descrição |
| - | - | - |
| XMAENCODER\_LOOP | 0x00000001 | Usa pontos de loop, se presentes, reamostrando a onda para que os pontos de loop fiquem alinhados a limites de 128 amostras. Se não houver pontos de loop, reproduz a onda em loop do início ao fim e a reamostra para que o fim do loop \[comprimento total] da onda fique alinhado a um limite de 128 amostras. |
| XMAENCODER\_NOFILTER | 0x00000002 | Não define nenhuma filtragem. |
| XMAENCODER\_DECODEFROMXMA | 0x00000004 | Não compatível com o codificador em memória. |
| XMAENCODER\_VERBOSE | 0x00000008 | Habilita a saída de depuração. |
| XMAENCODER\_PACKSTREAMS | 0x00000010 | Agrupa os canais no menor número possível de fluxos. |

*BlockSizeInKbytes*
Tipo: DWORD

Tamanho do bloco de compactação XMA2 a ser usado, em KB (2 a 8190). Não pode ser zero.

*ppEncodedBuffer*
Tipo: VOID \*\*

Ponteiro para um ponteiro para o buffer que conterá os dados codificados.

*pEncodedBufferSize*
Tipo: DWORD \*

Ponteiro para um DWORD que conterá o tamanho do buffer codificado.

*ppEncodedBufferFormat*
Tipo: XMA2WAVEFORMATEX \*\*

Ponteiro para um ponteiro para uma estrutura que conterá os detalhes de formato dos fluxos codificados.

*pEncodedBufferFormatSize*
Tipo: DWORD \*

Ponteiro para um DWORD que conterá o tamanho da estrutura de formato.

*ppSeekTable*
Tipo: DWORD \*\*

Ponteiro para um ponteiro que conterá a tabela de busca.

*pSeekTableSize*
Tipo: DWORD \*

Ponteiro para um DWORD que conterá o tamanho da tabela de busca.

<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 | Implementação | Descrição |
| - | - | - |
| XMAENCODER\_E\_OUTOFMEMORY | E\_OUTOFMEMORY | Memória insuficiente. |
| XMAENCODER\_E\_INVALIDARG | E\_INVALIDARG | Argumento inválido. |
| XMAENCODER\_E\_NOTIMPL | E\_NOTIMPL | Não implementado. |
| XMAENCODER\_E\_FAIL | E\_FAIL | Erro desconhecido. |
| XMAENCODER\_E\_INVALIDLOOP | XMAENCODERERROR(0x001) | Os pontos de loop são inválidos. |
| XMAENCODER\_E\_UNSUPPORTEDFORMAT | XMAENCODERERROR(0x002) | O formato é inválido. |
| XMAENCODER\_E\_OUTOFRANGE | XMAENCODERERROR(0x003) | O parâmetro está fora do intervalo válido. |
| XMAENCODER\_E\_READFAILED | XMAENCODERERROR(0x004) | Falha na operação de leitura. |
| XMAENCODER\_E\_INVALIDFRAME | XMAENCODERERROR(0x005) | Quadro XMA inválido. |
| XMAENCODER\_E\_INCOMPLETEFRAME | XMAENCODERERROR(0x006) | Quadro XMA incompleto. |
| XMAENCODER\_E\_ZEROSTUFFINGBIT | XMAENCODERERROR(0x007) | O bit de preenchimento é zero. |
| XMAENCODER\_E\_GETDATAFAILED | XMAENCODERERROR(0x008) | Falha na busca de dados. |

<a id="requirements" />

## Requisitos

**Cabeçalho:** xmaencoder.h

**Biblioteca:** xmaencoder.lib

## Confira também

[Ferramenta de codificação XMA2](/pt-BR/build/console-features/audio/tools/xma2encodertool)


## Related topics

- [Funções do XMA2encoder](/pt-BR/build/console-features/audio/tools/xma2encoder/tech-xmaencoder-funcs.md)
- [Informações de referência do codificador XMA2](/pt-BR/build/console-features/audio/tools/xma2encoder/atoc-xmaencoder.md)
- [Ferramenta de codificação XMA2](/pt-BR/build/console-features/audio/tools/xma2encodertool.md)
- [XWMAEncoder](/pt-BR/build/console-features/audio/tools/xwmaencoder/methods/xwmaencoder-xwmaencoder-xbox-microsoft-m.md)
- [XAudio2CreateWithSharedContexts](/pt-BR/reference/audio/xaudio2xbox/functions/xaudio2createwithsharedcontexts.md)