> ## 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 Obtiene la magnitud de pico. ## Sintaxis ```cpp theme={null} float GetShapeDmaPeakMagnitude( const SHAPE_DMA_CONTEXT* context ) ``` ### Parámetros *context*   \_In\_\ Tipo: [SHAPE\_DMA\_CONTEXT\*](/reference/audio/shapedmacontext/structs/shape_dma_context) Puntero a una estructura [SHAPE\_DMA\_CONTEXT](/reference/audio/shapedmacontext/structs/shape_dma_context). ### Valor devuelto Tipo: float La magnitud de pico. ## Comentarios En el motor de audio de un título, administrar el margen puede resultar muy difícil. Por este motivo, cada bloque de [SHAPE](/build/console-features/audio/overviews/shape-overview) mantiene un estado asociado a la sobrecarga y la ganancia de la señal. Cada bloque (excepto los bloques del convertidor de frecuencia de muestreo \[SRC]) registra si se ha producido saturación interna durante el procesamiento. Además de la marca de saturación interna, cada bloque de hardware también mantiene dos números de 4 bits que representan la magnitud de la salida del bloque de hardware. La magnitud se calcula determinando el pico de salida durante el fotograma de audio y contando los ceros iniciales del valor absoluto del pico. Un número de 4 bits se mantiene con la magnitud de pico persistente; el otro lo restablece el hardware en cada fotograma de audio. Además de supervisar la magnitud de pico de cada bloque de hardware individual, también se mantiene la magnitud de pico de los búferes de mezcla. A medida que la salida de un bloque de hardware se agrega a un búfer de mezcla, la magnitud de pico se calcula de la misma manera (contando los ceros iniciales). Cada estado de bloque de hardware mantiene un par adicional de valores de magnitud de pico de 4 bits. Estos valores representan la magnitud de pico del búfer de mezcla después de que la salida del bloque de hardware se haya acumulado en el búfer de mezcla. Un número de 4 bits representa la magnitud de pico persistente y continua; el otro se actualiza en cada fotograma de audio. Los valores de magnitud de pico se guardan en el contexto de los bloques de SHAPE, aunque en realidad se representa el estado del búfer de mezcla. La magnitud de pico se codifica según la tabla siguiente. | Valor binario | Descripción | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 0B0000 | Saturación: un valor de un cálculo para producir una salida desbordó el intervalo de 24 bits con signo y se reemplazó por el extremo más cercano. En concreto, un valor mayor que 8.388.607 (0x7F\_FFFF) se reemplazó por 8.388.607, o un valor menor que -8.388.608 (0x80\_0000) se reemplazó por -8.388.608. | | 0B0001 | El valor absoluto del pico fue mayor que MAX >> 1 (0x3F\_FFFF). | | 0B0010 | El valor absoluto del pico fue mayor que MAX >> 2 (0x1F\_FFFF). | | 0B0011 | El valor absoluto del pico fue mayor que MAX >> 3. | | 0B0100 | El valor absoluto del pico fue mayor que MAX >> 4. | | 0B0101 | El valor absoluto del pico fue mayor que MAX >> 5. | | 0B0110 a 0B1101 | Similar a las descripciones anteriores, pero cuando el valor absoluto del pico fue mayor que MAX >> 6 a 13. | | 0B1110 | El valor absoluto del pico fue mayor que MAX >> 14. | | 0B1111 | El valor absoluto del pico fue menor o igual que MAX >> 14. | Para ayudar a administrar la sobrecarga y evitar el desbordamiento y la saturación, además de la configuración de ganancia de grano fino, se puede realizar un desplazamiento a la derecha de 0 a 7 bits en la salida de un bloque de hardware antes de la acumulación en el búfer de mezcla de salida. Esto se designa en el contexto de cada bloque de hardware de SHAPE. ## Requisitos **Encabezado:** shapedmacontext.h **Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series ## Consulte también [Información general sobre SHAPE](/build/console-features/audio/overviews/shape-overview)\ [ShapeDmaContext](/reference/audio/shapedmacontext/shapedmacontext_members) ## Related topics - [ShapeDmaContext](/es/reference/audio/shapedmacontext/shapedmacontext_members.md) - [GetShapeDmaMixBufferPeakMagnitude](/es/reference/audio/shapedmacontext/functions/getshapedmamixbufferpeakmagnitude.md) - [GetShapeFiltVolPeakMagnitude](/es/reference/audio/shapefiltvolcontext/functions/getshapefiltvolpeakmagnitude.md) - [GetShapeEqCompPeakMagnitude](/es/reference/audio/shapeeqcompcontext/functions/getshapeeqcomppeakmagnitude.md) - [GetShapeEqCompMixBufferPeakMagnitude](/es/reference/audio/shapeeqcompcontext/functions/getshapeeqcompmixbufferpeakmagnitude.md)