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

# SetShapePcmLoopEnd

> SetShapePcmLoopEnd

# SetShapePcmLoopEnd

Define o fim do loop para amostras não alinhadas a quadros.

## Sintaxe

```cpp theme={null}
HRESULT SetShapePcmLoopEnd(  
         SHAPE_PCM_CONTEXT* context,  
         UINT32 loopEndInSamples  
)  
```

### Parâmetros

*context*   \_Inout\_\
Tipo: [SHAPE\_PCM\_CONTEXT\*](/pt-BR/reference/audio/shapepcmcontext/structs/shape_pcm_context)

Ponteiro para uma estrutura [SHAPE\_PCM\_CONTEXT](/pt-BR/reference/audio/shapepcmcontext/structs/shape_pcm_context).

*loopEndInSamples*   \
Tipo: UINT32

Especifica o fim do loop.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou erro HRESULT.

## Comentários

| Função | Descrição |
| - | - |
| PCM linear sem loop | Inicie a voz usando a constante `SHAPE_SRC_COMMAND_TYPE_START` para o Sample Rate Convertor (SRC). Deixe a voz ser reproduzida até o fim ou, opcionalmente, pare-a antes do fim usando a constante `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`. Para obter mais informações, confira a enumeração [SHAPE\_SRC\_COMMAND\_TYPE](/pt-BR/reference/audio/shapesrccontext/enums/shape_src_command_type). |
| PCM linear com loop infinito | Defina a contagem de loops do contexto Pulse Code Modulation (PCM) *loopCount* como a constante `SHAPE_PCM_INFINITE_LOOP_COUNT`. Inicie a voz usando `SHAPE_SRC_COMMAND_TYPE_START` para o SRC. Deixe a voz ser reproduzida até que você queira parar, seja no fim de um loop usando `SHAPE_SRC_COMMAND_TYPE_STOP_END` e deixando a voz terminar de ser reproduzida, ou imediatamente usando `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`. |
| PCM linear com loop finito | Defina a contagem de loops do contexto PCM *loopCount* como \[0, 254]. Inicie a voz usando `SHAPE_SRC_COMMAND_TYPE_START` para o SRC. Deixe a voz ser reproduzida até o fim ou, opcionalmente, pare-a no fim de um loop usando `SHAPE_SRC_COMMAND_TYPE_STOP_END` e deixe a voz terminar de ser reproduzida, ou pare-a imediatamente usando `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`. |
| PCM circular | Inicie a voz usando `SHAPE_SRC_COMMAND_TYPE_START` para o SRC. Continue transmitindo dados, atualizando o ponteiro de gravação do contexto PCM, até que você queira parar. Use `SHAPE_SRC_COMMAND_TYPE_STOP_END` para permitir que o SRC reproduza até o ponteiro de gravação PCM atual `loopStartWritePointer`, ou `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE` para pará-lo imediatamente. |

## Requisitos

**Cabeçalho:** shapepcmcontext.h

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

## Confira também

[Visão geral do ACP](/pt-BR/build/console-features/audio/overviews/acp-overview)\
[Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview)\
[shapepcmcontext](/pt-BR/reference/audio/shapepcmcontext/shapepcmcontext_members)


## Related topics

- [ShapePcmContext](/pt-BR/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SetShapePcmLoopCount](/pt-BR/reference/audio/shapepcmcontext/functions/setshapepcmloopcount.md)
- [SetShapePcmLoopStartOrWritePointer](/pt-BR/reference/audio/shapepcmcontext/functions/setshapepcmloopstartorwritepointer.md)
- [GetShapePcmLoopEnd](/pt-BR/reference/audio/shapepcmcontext/functions/getshapepcmloopend.md)
- [SetShapeXmaLoopEndOffset](/pt-BR/reference/audio/shapexmacontext/functions/setshapexmaloopendoffset.md)