> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetShapeDmaPeakMagnitude

> GetShapeDmaPeakMagnitude

# GetShapeDmaPeakMagnitude

Obtient la magnitude de crête.

## Syntaxe

```cpp theme={null}
float GetShapeDmaPeakMagnitude(  
         const SHAPE_DMA_CONTEXT* context  
)  
```

### Paramètres

*context*   \_In\_\
Type : [SHAPE\_DMA\_CONTEXT\*](/fr/reference/audio/shapedmacontext/structs/shape_dma_context)

Pointeur vers une structure [SHAPE\_DMA\_CONTEXT](/fr/reference/audio/shapedmacontext/structs/shape_dma_context).

### Valeur renvoyée

Type : float

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](/fr/build/console-features/audio/overviews/shape-overview) conserve un état associé à la marge du signal et au gain. Chaque bloc (à l'exception des blocs de conversion de fréquence d'échantillonnage \[SRC]) enregistre si une saturation interne s'est produite pendant le traitement.

Outre 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 crête de sortie 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 tampons de mixage est également conservée. Lorsque la sortie d'un bloc matériel est ajoutée à un 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 du tampon de mixage après l'accumulation de la sortie du bloc matériel dans le 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 réalité l'état du tampon de mixage qui est représenté.

La magnitude de crête est encodée selon le tableau suivant.

| Valeur binaire | Description |
| - | - |
| 0B0000 | Saturation : une valeur issue d'un calcul destiné à produire une sortie a dépassé la plage signée de 24 bits et a été remplacée par l'extrême le plus proche. Plus précisément, une valeur supérieure à 8 388 607 (0x7F\_FFFF) a été remplacée par 8 388 607 ou une valeur inférieure à -8 388 608 (0x80\_0000) a été remplacée par -8 388 608. |
| 0B0001 | La valeur absolue de la crête était supérieure à MAX >> 1 (0x3F\_FFFF). |
| 0B0010 | La valeur absolue de la crête était supérieure à MAX >> 2 (0x1F\_FFFF). |
| 0B0011 | La valeur absolue de la crête était supérieure à MAX >> 3. |
| 0B0100 | La valeur absolue de la crête était supérieure à MAX >> 4. |
| 0B0101 | La valeur absolue de la crête était supérieure à MAX >> 5. |
| 0B0110 à 0B1101 | Semblable aux descriptions ci-dessus, mais lorsque la valeur absolue de la crête était supérieure à MAX >> 6 à 13. |
| 0B1110 | La valeur absolue de la crête était supérieure à MAX >> 14. |
| 0B1111 | La valeur absolue de la crête était inférieure ou égale à MAX >> 14. |

Pour faciliter la gestion de la marge et éviter les dépassements 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 son accumulation dans le tampon de mixage de sortie. Ce décalage est défini 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 Series

## Voir aussi

[Vue d'ensemble de SHAPE](/fr/build/console-features/audio/overviews/shape-overview)\
[ShapeDmaContext](/fr/reference/audio/shapedmacontext/shapedmacontext_members)


## Related topics

- [ShapeDmaContext](/fr/reference/audio/shapedmacontext/shapedmacontext_members.md)
- [GetShapeDmaMixBufferPeakMagnitude](/fr/reference/audio/shapedmacontext/functions/getshapedmamixbufferpeakmagnitude.md)
- [GetShapeEqCompPeakMagnitude](/fr/reference/audio/shapeeqcompcontext/functions/getshapeeqcomppeakmagnitude.md)
- [GetShapeFiltVolPeakMagnitude](/fr/reference/audio/shapefiltvolcontext/functions/getshapefiltvolpeakmagnitude.md)
- [GetShapeEqCompMixBufferPeakMagnitude](/fr/reference/audio/shapeeqcompcontext/functions/getshapeeqcompmixbufferpeakmagnitude.md)