> ## 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

Obtém a magnitude de pico.

## Sintaxe

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

### Parâmetros

*context*   \_In\_\
Tipo: [SHAPE\_DMA\_CONTEXT\*](/pt-BR/reference/audio/shapedmacontext/structs/shape_dma_context)

Ponteiro para uma estrutura [SHAPE\_DMA\_CONTEXT](/pt-BR/reference/audio/shapedmacontext/structs/shape_dma_context).

### Valor retornado

Tipo: float

A magnitude de pico.

## Comentários

Em um mecanismo de áudio de um título, gerenciar o headroom pode ser muito difícil. Por esse motivo, cada bloco do [SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview) mantém o estado associado à sobrecarga e ao ganho do sinal. Cada bloco (exceto os blocos do Sample Rate Convertor \[SRC]) registra se ocorreu saturação interna durante o processamento.

Além do sinalizador de saturação interna, cada bloco de hardware também mantém dois números de 4 bits que representam a magnitude da saída do bloco de hardware. A magnitude é calculada determinando a saída de pico durante o quadro de áudio e contando os zeros à esquerda do valor absoluto do pico. Um número de 4 bits é mantido com a magnitude de pico persistente; o outro é redefinido pelo hardware a cada quadro de áudio.

Além de monitorar a magnitude de pico de cada bloco de hardware individual, a magnitude de pico dos buffers de mixagem também é mantida. À medida que a saída de um bloco de hardware é adicionada a um buffer de mixagem, a magnitude de pico é calculada da mesma maneira (contando os zeros à esquerda). O estado de cada bloco de hardware mantém um par adicional de valores de magnitude de pico de 4 bits. Esses valores representam a magnitude de pico do buffer de mixagem depois que a saída do bloco de hardware é acumulada no buffer de mixagem. Um número de 4 bits representa a magnitude de pico contínua e persistente; o outro é atualizado a cada quadro de áudio. Os valores de magnitude de pico são salvos no contexto dos blocos do SHAPE, embora o estado do buffer de mixagem seja o que está de fato sendo representado.

A magnitude de pico é codificada de acordo com a tabela a seguir.

| Valor binário | Descrição |
| - | - |
| 0B0000 | Saturação: um valor de um cálculo para produzir uma saída excedeu o intervalo de 24 bits com sinal e foi substituído pelo extremo mais próximo. Especificamente, um valor maior que 8.388.607 (0x7F\_FFFF) foi substituído por 8.388.607 ou um valor menor que -8.388.608 (0x80\_0000) foi substituído por -8.388.608. |
| 0B0001 | O valor absoluto do pico foi maior que MAX >> 1 (0x3F\_FFFF). |
| 0B0010 | O valor absoluto do pico foi maior que MAX >> 2 (0x1F\_FFFF). |
| 0B0011 | O valor absoluto do pico foi maior que MAX >> 3. |
| 0B0100 | O valor absoluto do pico foi maior que MAX >> 4. |
| 0B0101 | O valor absoluto do pico foi maior que MAX >> 5. |
| 0B0110 a 0B1101 | Semelhante às descrições acima, mas quando o valor absoluto do pico foi maior que MAX >> 6 a 13. |
| 0B1110 | O valor absoluto do pico foi maior que MAX >> 14. |
| 0B1111 | O valor absoluto do pico foi menor ou igual a MAX >> 14. |

Para ajudar a gerenciar a sobrecarga e evitar estouro e saturação, além das configurações de ganho refinadas, um deslocamento à direita de 0 a 7 bits pode ser realizado na saída de um bloco de hardware antes da acumulação no buffer de mixagem de saída. Isso é designado no contexto de cada bloco de hardware do SHAPE.

## Requisitos

**Cabeçalho:** shapedmacontext.h

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview)\
[ShapeDmaContext](/pt-BR/reference/audio/shapedmacontext/shapedmacontext_members)


## Related topics

- [GetShapeDmaPeakMagnitude](/reference/audio/shapedmacontext/functions/getshapedmapeakmagnitude.md)
- [ShapeDmaContext](/reference/audio/shapedmacontext/shapedmacontext_members.md)