SHAPE_XMA_CONTEXT

Contexte XBOX Media Audio (XMA).

Syntaxe

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  

Membres

sizeRead0
Type : UINT32 Écriture : taille, en blocs de 2 Ko, de la mémoire tampon d’entrée gauche. numLoops
Type : UINT32 Lecture/écriture : nombre de boucles. 255 spécifie une boucle infinie (continue). validBuffer
Type : UINT32 Lecture/écriture : indicateurs de validité des mémoires tampons d’entrée.

Valeur	Description
00	Aucune mémoire tampon n’est valide.
01	Seule la mémoire tampon 0 (gauche) est valide.
10	Seule la mémoire tampon 1 (droite) est valide.
11	Les deux mémoires tampons sont valides.

sizeWrite
Type : UINT32 Écriture : taille, en blocs de 256 octets, de la mémoire tampon de sortie. offsetWrite
Type : UINT32 Lecture : décalage, en blocs de 256 octets, dans la mémoire tampon de sortie où le matériel écrira. sizeRead1
Type : UINT32 Écriture : taille, en blocs de 2 Ko, de la mémoire tampon d’entrée droite. loopSubframeEnd
Type : UINT32 Écriture : numéro de la sous-trame du point de fin de la boucle, inclusivement. reserved0
Type : UINT32 Réservé. loopSubframeSkip
Type : UINT32 Écriture : nombre de sous-trames à ignorer au début de la boucle. Les valeurs valides sont 0, 1, 2, 3 et 4. numSubframesToDecode
Type : UINT32 Écriture : nombre de sous-trames à décoder par passe. Les valeurs valides sont 1, 2, 4 et 8. numSubframesToSkip
Type : UINT32 Écriture : nombre de sous-trames à ignorer. Les valeurs valides sont 0, 1, 2, 3 et 4. sampleRate
Type : UINT32 Écriture : fréquence d’échantillonnage du flux. Les valeurs valides figurent dans l’énumération SHAPE_XMA_SAMPLE_RATE. numChannels
Type : UINT32 Écriture : nombre de canaux du flux. 0 spécifie mono (un canal); 1 spécifie stéréo (deux canaux). reserved1
Type : UINT32 Réservé. validWrite
Type : UINT32 Lecture/écriture : indicateur de validité de la mémoire tampon d’écriture. 1 indique que le matériel peut écrire; 0 indique que le matériel ne peut pas écrire. offsetRead
Type : UINT32 Lecture/écriture : décalage, en bits, à partir du début de la mémoire tampon d’entrée. errorStatus
Type : UINT32 Lecture : une ou plusieurs valeurs d’erreur.

Erreur	Valeur
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
Type : UINT32 Lecture : indicateur d’erreur. 0 si aucune erreur ne s’est produite; 1 si une erreur s’est produite. Utilisez GetShapeXmaErrorStatus pour récupérer les valeurs d’erreur. loopStartOffset
Type : UINT32 Écriture : décalage, en bits, à partir du pointeur de la mémoire tampon de lecture où le matériel commencera le décodage. parserErrorStatus
Type : UINT32 Lecture : valeur d’erreur de l’analyseur.

Erreur	Valeur
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
Type : UINT32 Lecture : indicateur d’erreur de l’analyseur. 0 si aucune erreur ne s’est produite; 1 si une erreur s’est produite. Utilisez GetShapeXmaParserErrorStatus pour récupérer la valeur d’erreur. loopEndOffset
Type : UINT32 Écriture : décalage, en bits, à partir du pointeur de la mémoire tampon de lecture où le matériel terminera le décodage. packetMetaData
Type : UINT32 Réservé à un usage interne. currentBuffer
Type : UINT32 Lecture/écriture : mémoire tampon d’entrée actuelle. 0 spécifie la mémoire tampon gauche et 1, la mémoire tampon droite. ptrRead0
Type : UINT32 Écriture : pointeur vers la mémoire tampon d’entrée gauche. Aligné sur des limites de 2 Ko; les 11 bits inférieurs sont ignorés. ptrRead1
Type : UINT32 Écriture : pointeur vers la mémoire tampon d’entrée droite. Aligné sur des limites de 2 Ko; les 11 bits inférieurs sont ignorés. ptrWrite
Type : UINT32 Écriture : pointeur vers la mémoire tampon de sortie. Aligné sur des limites de 64 octets. ptrOverlapAdd
Type : UINT32 Écriture : pointeur vers la mémoire tampon de travail. Aligné sur des limites de 128 octets. writeBufferOffsetRead
Type : UINT32 Écriture : décalage, en blocs de 256 octets, du pointeur de lecture dans la mémoire tampon de sortie. reserved2
Type : UINT32 Réservé. stopWhenDone
Type : UINT32 Réservé à un usage interne. interruptWhenDone
Type : UINT32 Réservé à un usage interne. reserved
Type : UINT32[6] Réservé.

Remarques

Cette structure contient le contexte du bloc décodeur XMA. La taille maximale d’une mémoire tampon d’entrée est de 8 Mo. Pour déterminer l’état de consommation d’une mémoire tampon d’entrée, examinez les membres offsetRead, currentBuffer et validBuffer. Les membres marqués Lecture sont écrits par la bibliothèque Audio Control Processor (ACP) et ne doivent être que lus par votre application. Les membres marqués Écriture sont définis par votre application et ne sont pas modifiés par la bibliothèque ACP. Les membres marqués Lecture/écriture sont définis par votre application, mais peuvent être modifiés par la bibliothèque ACP. Pour plus d’informations, consultez la section XMA de la Vue d’ensemble de SHAPE.

Configuration requise

En-tête : shapexmacontext.h Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Vue d’ensemble d’ACP

Voir aussi

ShapeXmaContext

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

SHAPE_XMA_CONTEXT

SHAPE_XMA_CONTEXT

Syntaxe

Membres

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi

​SHAPE_XMA_CONTEXT

​Syntaxe

​Membres

​Remarques

​Configuration requise

​Documentation conceptuelle

​Voir aussi

SHAPE_XMA_CONTEXT

Syntaxe

Membres

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi