XAudio2XMAEncoder

Codifica os fluxos de entrada no formato XMA.

Sintaxe

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)  

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.

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.

Requisitos

Cabeçalho: xmaencoder.h Biblioteca: xmaencoder.lib

Confira também

Ferramenta de codificação XMA2

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

Sintaxe

Parâmetros

Valor retornado

Requisitos

Confira também

​Sintaxe

​Parâmetros

​Valor retornado

​Requisitos

​Confira também

Sintaxe

Parâmetros

Valor retornado

Requisitos

Confira também