GetShapeDmaMixBufferPeakMagnitude
Obtient la magnitude de crête de la mémoire tampon de mixage de l’accès direct à la mémoire (DMA).Syntaxe
Paramètres
context _In_Type : SHAPE_DMA_CONTEXT* Pointeur vers une structure SHAPE_DMA_CONTEXT.
Valeur de retour
Type : float La magnitude de crête.Remarques
Dans le moteur audio d’un titre, la gestion de la marge dynamique peut être très difficile. C’est pourquoi chaque bloc SHAPE conserve un état associé à la marge du signal et au gain. Chaque bloc (à l’exception des blocs de convertisseur de fréquence d’échantillonnage [SRC]) enregistre si une saturation interne s’est produite pendant le traitement. En plus de l’indicateur de saturation interne, chaque bloc matériel conserve également deux nombres de 4 bits représentant la magnitude de la sortie du bloc matériel. La magnitude est calculée en déterminant la sortie de crête pendant la trame audio et en comptant les zéros de tête de la valeur absolue de la crête. L’un des nombres de 4 bits conserve la magnitude de crête persistante; l’autre est réinitialisé par le matériel à chaque trame audio. En plus de la surveillance de la magnitude de crête de chaque bloc matériel, la magnitude de crête des mémoires tampons de mixage est également conservée. Lorsque la sortie d’un bloc matériel est ajoutée à une mémoire tampon de mixage, la magnitude de crête est calculée de la même manière (en comptant les zéros de tête). L’état de chaque bloc matériel conserve une paire supplémentaire de valeurs de magnitude de crête de 4 bits. Ces valeurs représentent la magnitude de crête de la mémoire tampon de mixage après l’accumulation de la sortie du bloc matériel dans la mémoire tampon de mixage. L’un des nombres de 4 bits représente la magnitude de crête persistante en cours; l’autre est mis à jour à chaque trame audio. Les valeurs de magnitude de crête sont enregistrées dans le contexte des blocs SHAPE, même si c’est en fait l’état de la mémoire tampon de mixage qui est représenté. La magnitude de crête est encodée selon le tableau suivant.
Pour aider à gérer la marge et éviter le dépassement et la saturation, en plus des réglages de gain précis, un décalage à droite de 0 à 7 bits peut être appliqué à la sortie d’un bloc matériel avant l’accumulation dans la mémoire tampon de mixage de sortie. Ce décalage est désigné dans le contexte de chaque bloc matériel SHAPE.
Configuration requise
En-tête : shapedmacontext.h Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
Vue d’ensemble de SHAPEShapeDmaContext