Skip to main content

GetShapeDmaFramesFree

Obtient le nombre de trames disponibles pour l’écriture.

Syntaxe

Paramètres

context   _In_
Type : SHAPE_DMA_CONTEXT*
Pointeur vers une structure SHAPE_DMA_CONTEXT.

Valeur de retour

Type : UINT32 Nombre de trames disponibles pour l’écriture.

Remarques

Vous pouvez éviter les commandes d’accès direct à la mémoire (DMA) bloquées en vous assurant que votre mémoire tampon audio est suffisamment grande et que les données sont diffusées à intervalles réguliers (en fonction de la taille de la mémoire tampon). Par exemple, si vous diffusez quatre trames matérielles à la fois, assurez-vous qu’un multiple de ces trames (au moins une double mise en mémoire tampon de huit trames) se trouve dans la mémoire tampon afin que le matériel puisse écrire en avance sur le pointeur de lecture du titre. Vous pourriez aussi forcer le vidage de la mémoire tampon avant de soumettre le graphe de flux suivant (consommer, mettre à jour le pointeur de lecture DMA, puis soumettre le graphe de flux). Pour plus de détails, consultez Commandes bloquées dans Vue d’ensemble de SHAPE. Le système DMA prend en charge les fonctionnalités de lecture et d’écriture avec conversion automatique de virgule flottante en entier et d’entier en virgule flottante. Le système DMA utilise des mémoires tampons circulaires contenant des échantillons désentrelacés en blocs de 128 échantillons. Le processeur DMA permet au moteur SHAPE (Scalable Hardware Audio Processing Engine) d’envoyer des données des mémoires tampons de mixage vers la mémoire système principale et de récupérer des données de la mémoire système principale dans les mémoires tampons de mixage pour un traitement ultérieur. Le DMA s’effectue par blocs, en transférant une trame audio de données à la fois. Pour faciliter les données entrelacées par blocs, une valeur de saut indique le nombre de blocs de trames audio à ignorer dans la mémoire système (à partir de l’adresse de base) lors de la lecture ou de l’écriture d’échantillons. Les flux multicanaux nécessitent donc un contexte DMA par canal. Les échantillons de données audio sont toujours lus et écrits sous forme de valeurs 32 bits, entières ou à virgule flottante, comme indiqué par l’indicateur floatConvert de la structure SHAPE_DMA_CONTEXT. Notez que la direction du DMA (lecture ou écriture) est spécifiée dans la commande DMA, et non dans le contexte DMA. Cela aide à réduire la quantité de bande passante de données. Le moteur DMA n’effectue aucun traitement du signal, mais peut effectuer une conversion de virgule flottante en entier (ou d’entier en virgule flottante). Cela permet au processeur de l’application de traiter les échantillons de données au format virgule flottante. Pour calculer la taille d’une mémoire tampon DMA, utilisez la formule suivante :
Les pointeurs de lecture et d’écriture sont incrémentés comme suit :
Les adresses dans la mémoire tampon audio sont calculées comme suit :

Configuration requise

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

Voir aussi

ShapeDmaContext
Last modified on October 6, 2026