SHAPE_XMA_CONTEXT

El contexto de XBOX Media Audio (XMA).

Sintaxis

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  

Miembros

sizeRead0
Tipo: UINT32 Escritura: tamaño, en bloques de 2 KB, del búfer de entrada izquierdo. numLoops
Tipo: UINT32 Lectura/escritura: número de bucles. 255 especifica un bucle infinito (continuo). validBuffer
Tipo: UINT32 Lectura/escritura: marcas de validez de los búferes de entrada.

Valor	Descripción
00	Ningún búfer es válido.
01	Solo el búfer 0 (izquierdo) es válido.
10	Solo el búfer 1 (derecho) es válido.
11	Ambos búferes son válidos.

sizeWrite
Tipo: UINT32 Escritura: tamaño, en bloques de 256 bytes, del búfer de salida. offsetWrite
Tipo: UINT32 Lectura: desplazamiento, en bloques de 256 bytes, dentro del búfer de salida donde escribirá el hardware. sizeRead1
Tipo: UINT32 Escritura: tamaño, en bloques de 2 KB, del búfer de entrada derecho. loopSubframeEnd
Tipo: UINT32 Escritura: número de subfotograma del punto final del bucle, inclusive. reserved0
Tipo: UINT32 Reservado. loopSubframeSkip
Tipo: UINT32 Escritura: número de subfotogramas que se omitirán al principio del bucle. Los valores válidos son 0, 1, 2, 3 y 4. numSubframesToDecode
Tipo: UINT32 Escritura: número de subfotogramas que se descodificarán por pasada. Los valores válidos son 1, 2, 4 y 8. numSubframesToSkip
Tipo: UINT32 Escritura: número de subfotogramas que se omitirán. Los valores válidos son 0, 1, 2, 3 y 4. sampleRate
Tipo: UINT32 Escritura: frecuencia de muestreo de la secuencia. Los valores válidos están en la enumeración SHAPE_XMA_SAMPLE_RATE. numChannels
Tipo: UINT32 Escritura: número de canales de la secuencia. 0 especifica mono (un canal); 1 especifica estéreo (dos canales). reserved1
Tipo: UINT32 Reservado. validWrite
Tipo: UINT32 Lectura/escritura: marca de validez del búfer de escritura. 1 indica que el hardware puede escribir; 0 indica que el hardware no puede escribir. offsetRead
Tipo: UINT32 Lectura/escritura: desplazamiento, en bits, desde el principio del búfer de entrada. errorStatus
Tipo: UINT32 Lectura: uno o varios valores de error.

Error	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 Lectura: marca de error. 0 si no se ha producido ningún error; 1 si se ha producido un error. Use GetShapeXmaErrorStatus para recuperar los valores de error. loopStartOffset
Tipo: UINT32 Escritura: desplazamiento, en bits, desde el puntero del búfer de lectura donde el hardware comenzará a descodificar. parserErrorStatus
Tipo: UINT32 Lectura: valor de error del analizador.

Error	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 Lectura: marca de error del analizador. 0 si no se ha producido ningún error; 1 si se ha producido un error. Use GetShapeXmaParserErrorStatus para recuperar el valor de error. loopEndOffset
Tipo: UINT32 Escritura: desplazamiento, en bits, desde el puntero del búfer de lectura donde el hardware finalizará la descodificación. packetMetaData
Tipo: UINT32 Reservado para uso interno. currentBuffer
Tipo: UINT32 Lectura/escritura: búfer de entrada actual. 0 especifica el búfer izquierdo y 1 especifica el búfer derecho. ptrRead0
Tipo: UINT32 Escritura: puntero al búfer de entrada izquierdo. Alineado en límites de 2 KB; los 11 bits inferiores se omiten. ptrRead1
Tipo: UINT32 Escritura: puntero al búfer de entrada derecho. Alineado en límites de 2 KB; los 11 bits inferiores se omiten. ptrWrite
Tipo: UINT32 Escritura: puntero al búfer de salida. Alineado en límites de 64 bytes. ptrOverlapAdd
Tipo: UINT32 Escritura: puntero al búfer de trabajo. Alineado en límites de 128 bytes. writeBufferOffsetRead
Tipo: UINT32 Escritura: desplazamiento, en bloques de 256 bytes, del puntero de lectura en el búfer de salida. reserved2
Tipo: UINT32 Reservado. stopWhenDone
Tipo: UINT32 Reservado para uso interno. interruptWhenDone
Tipo: UINT32 Reservado para uso interno. reserved
Tipo: UINT32[6] Reservado.

Comentarios

Esta estructura contiene el contexto del bloque descodificador XMA. El tamaño máximo de un búfer de entrada es de 8 MB. Para determinar el estado de consumo de un búfer de entrada, examine los miembros offsetRead, currentBuffer y validBuffer. Los miembros marcados como Lectura son escritos por la biblioteca del procesador de control de audio (ACP) y solo deben ser leídos por la aplicación. Los miembros marcados como Escritura los establece la aplicación y la biblioteca de ACP no los cambia. Los miembros marcados como Lectura/escritura los establece la aplicación, pero la biblioteca de ACP puede cambiarlos. Para obtener más información, consulte la sección XMA de Información general de SHAPE.

Requisitos

Encabezado: shapexmacontext.h Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Información general de ACP

Consulte también

ShapeXmaContext

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

SHAPE_XMA_CONTEXT

SHAPE_XMA_CONTEXT

Sintaxis

Miembros

Comentarios

Requisitos

Documentación conceptual

Consulte también

​SHAPE_XMA_CONTEXT

​Sintaxis

​Miembros

​Comentarios

​Requisitos

​Documentación conceptual

​Consulte también

SHAPE_XMA_CONTEXT

Sintaxis

Miembros

Comentarios

Requisitos

Documentación conceptual

Consulte también