SHAPE_XMA_CONTEXT

O contexto XBOX Media Audio (XMA).

Sintaxe

typedef struct SHAPE_XMA_CONTEXT {  
    UINT32 sizeRead0 : 12;  
    UINT32 numLoops : 8;  
    UINT32 validBuffer : 2;  
    UINT32 sizeWrite : 5;  
    UINT32 offsetWrite : 5;  
    UINT32 sizeRead1 : 12;  
    UINT32 loopSubframeEnd : 2;  
    UINT32 reserved0 : 3;  
    UINT32 loopSubframeSkip : 3;  
    UINT32 numSubframesToDecode : 4;  
    UINT32 numSubframesToSkip : 3;  
    UINT32 sampleRate : 2;  
    UINT32 numChannels : 1;  
    UINT32 reserved1 : 1;  
    UINT32 validWrite : 1;  
    UINT32 offsetRead : 26;  
    UINT32 errorStatus : 5;  
    UINT32 errorSet : 1;  
    UINT32 loopStartOffset : 26;  
    UINT32 parserErrorStatus : 5;  
    UINT32 parserErrorSet : 1;  
    UINT32 loopEndOffset : 26;  
    UINT32 packetMetaData : 5;  
    UINT32 currentBuffer : 1;  
    UINT32 ptrRead0;  
    UINT32 ptrRead1;  
    UINT32 ptrWrite;  
    UINT32 ptrOverlapAdd;  
    UINT32 writeBufferOffsetRead : 5;  
    UINT32 reserved2 : 25;  
    UINT32 stopWhenDone : 1;  
    UINT32 interruptWhenDone : 1;  
    UINT32 reserved[6];  
} SHAPE_XMA_CONTEXT  

Membros

sizeRead0
Tipo: UINT32 Gravação: tamanho, em blocos de 2 KB, do buffer de entrada esquerdo. numLoops
Tipo: UINT32 Leitura/Gravação: número de loops. 255 especifica loop infinito (contínuo). validBuffer
Tipo: UINT32 Leitura/Gravação: sinalizadores de validade dos buffers de entrada.

Valor	Descrição
00	Nenhum buffer é válido.
01	Somente o buffer 0 (esquerdo) é válido.
10	Somente o buffer 1 (direito) é válido.
11	Ambos os buffers são válidos.

sizeWrite
Tipo: UINT32 Gravação: tamanho, em blocos de 256 bytes, do buffer de saída. offsetWrite
Tipo: UINT32 Leitura: deslocamento, em blocos de 256 bytes, no buffer de saída onde o hardware gravará. sizeRead1
Tipo: UINT32 Gravação: tamanho, em blocos de 2 KB, do buffer de entrada direito. loopSubframeEnd
Tipo: UINT32 Gravação: número do subquadro do ponto final do loop, inclusive. reserved0
Tipo: UINT32 Reservado. loopSubframeSkip
Tipo: UINT32 Gravação: número de subquadros a serem ignorados no início do loop. Os valores válidos são 0, 1, 2, 3 e 4. numSubframesToDecode
Tipo: UINT32 Gravação: número de subquadros a serem decodificados por passagem. Os valores válidos são 1, 2, 4 e 8. numSubframesToSkip
Tipo: UINT32 Gravação: número de subquadros a serem ignorados. Os valores válidos são 0, 1, 2, 3 e 4. sampleRate
Tipo: UINT32 Gravação: taxa de amostragem do fluxo. Os valores válidos estão na enumeração SHAPE_XMA_SAMPLE_RATE. numChannels
Tipo: UINT32 Gravação: número de canais no fluxo. 0 especifica mono (um canal); 1 especifica estéreo (dois canais). reserved1
Tipo: UINT32 Reservado. validWrite
Tipo: UINT32 Leitura/Gravação: sinalizador de validade do buffer de gravação. 1 indica que o hardware pode gravar; 0 indica que o hardware não pode gravar. offsetRead
Tipo: UINT32 Leitura/Gravação: deslocamento, em bits, a partir do início do buffer de entrada. errorStatus
Tipo: UINT32 Leitura: um ou mais valores de erro.

Erro	Valor
SHAPE_XMA_ERROR_STATUS_NO_ERROR_OCCURRED_ERRORSET_IS_0	0
SHAPE_XMA_ERROR_STATUS_WRITE_BUFFER_INVALID_VALIDWR_IS_0	1
SHAPE_XMA_ERROR_STATUS_INSUFFICIENT_WRITE_BUFFER_SPACE_VALIDWR_IS_1	2
SHAPE_XMA_ERROR_STATUS_READ_BUFFER_INVALID_VALIDBUFFER_CURRBUF_IS_0	4
SHAPE_XMA_ERROR_STATUS_FRAME_CROSSES_BOUNDARY_INTO_INVALID_READ_BUFFER_VALIDBUFFER_CURRBUF_IS_0	8
SHAPE_XMA_ERROR_STATUS_FRAME_CROSSES_BOTH_READ_BUFFER_BOUNDARIES	16

errorSet
Tipo: UINT32 Leitura: sinalizador de erro. 0 se nenhum erro ocorreu; 1 se ocorreu um erro. Use GetShapeXmaErrorStatus para recuperar os valores de erro. loopStartOffset
Tipo: UINT32 Gravação: deslocamento, em bits, a partir do ponteiro do buffer de leitura onde o hardware iniciará a decodificação. parserErrorStatus
Tipo: UINT32 Leitura: valor de erro do analisador.

Erro	Valor
SHAPE_XMA_PARSER_ERROR_STATUS_UNKNOWN_STATE	1
SHAPE_XMA_PARSER_ERROR_STATUS_OUT_OF_RANGE	2
SHAPE_XMA_PARSER_ERROR_STATUS_FRAME_SIZE_EXCEEDED	3
SHAPE_XMA_PARSER_ERROR_STATUS_BITSTREAM_CORRUPTION	4
SHAPE_XMA_PARSER_ERROR_STATUS_BARKVLC_ERROR	5
SHAPE_XMA_PARSER_ERROR_STATUS_BARKRLC_ERROR	6
SHAPE_XMA_PARSER_ERROR_STATUS_VLC4D_ERROR	7
SHAPE_XMA_PARSER_ERROR_STATUS_VLC2D_ERROR	8
SHAPE_XMA_PARSER_ERROR_STATUS_VLC1D_ERROR	9
SHAPE_XMA_PARSER_ERROR_STATUS_RLC0_ERROR	10
SHAPE_XMA_PARSER_ERROR_STATUS_RLC1_ERROR	11
SHAPE_XMA_PARSER_ERROR_STATUS_LARGEVAL24_ERROR	15

parserErrorSet
Tipo: UINT32 Leitura: sinalizador de erro do analisador. 0 se nenhum erro ocorreu; 1 se ocorreu um erro. Use GetShapeXmaParserErrorStatus para recuperar o valor de erro. loopEndOffset
Tipo: UINT32 Gravação: deslocamento, em bits, a partir do ponteiro do buffer de leitura onde o hardware encerrará a decodificação. packetMetaData
Tipo: UINT32 Reservado para uso interno. currentBuffer
Tipo: UINT32 Leitura/Gravação: buffer de entrada atual. 0 especifica o buffer esquerdo e 1 especifica o buffer direito. ptrRead0
Tipo: UINT32 Gravação: ponteiro para o buffer de entrada esquerdo. Alinhado em limites de 2 KB; os 11 bits inferiores são ignorados. ptrRead1
Tipo: UINT32 Gravação: ponteiro para o buffer de entrada direito. Alinhado em limites de 2 KB; os 11 bits inferiores são ignorados. ptrWrite
Tipo: UINT32 Gravação: ponteiro para o buffer de saída. Alinhado em limites de 64 bytes. ptrOverlapAdd
Tipo: UINT32 Gravação: ponteiro para o buffer de trabalho. Alinhado em limites de 128 bytes. writeBufferOffsetRead
Tipo: UINT32 Gravação: deslocamento, em blocos de 256 bytes, do ponteiro de leitura no buffer de saída. reserved2
Tipo: UINT32 Reservado. stopWhenDone
Tipo: UINT32 Reservado para uso interno. interruptWhenDone
Tipo: UINT32 Reservado para uso interno. reserved
Tipo: UINT32[6] Reservado.

Comentários

Essa estrutura contém o contexto do bloco decodificador XMA. O tamanho máximo de um buffer de entrada é de 8 MB. Para determinar o status do consumo de um buffer de entrada, examine os membros offsetRead, currentBuffer e validBuffer. Os membros marcados como Leitura são gravados pela biblioteca do ACP (Audio Control Processor) e devem ser apenas lidos pelo seu aplicativo. Os membros marcados como Gravação são definidos pelo seu aplicativo e não são alterados pela biblioteca do ACP. Os membros marcados como Leitura/Gravação são definidos pelo seu aplicativo, mas podem ser alterados pela biblioteca do ACP. Para obter mais informações, confira a seção XMA de Visão geral do SHAPE.

Requisitos

Cabeçalho: shapexmacontext.h Plataformas compatíveis: consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Visão geral do ACP

Confira também

ShapeXmaContext

Porting

Build Paths

SHAPE_XMA_CONTEXT

SHAPE_XMA_CONTEXT

Sintaxe

Membros

Comentários

Requisitos

Documentação conceitual

Confira também

​SHAPE_XMA_CONTEXT

​Sintaxe

​Membros

​Comentários

​Requisitos

​Documentação conceitual

​Confira também

SHAPE_XMA_CONTEXT

Sintaxe

Membros

Comentários

Requisitos

Documentação conceitual

Confira também