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

# SetShapePcmLoopCount

> SetShapePcmLoopCount

# SetShapePcmLoopCount

Establece el recuento de bucles.

## Sintaxis

```cpp theme={null}
HRESULT SetShapePcmLoopCount(  
         SHAPE_PCM_CONTEXT* context,  
         UINT32 loopCount  
)  
```

### Parámetros

*context*   \_Inout\_\
Tipo: [SHAPE\_PCM\_CONTEXT\*](https://docs.xbox.com/es/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)

Puntero a una estructura [SHAPE\_PCM\_CONTEXT](https://docs.xbox.com/es/reference/audio/shapepcmcontext/structs/shape_pcm_context.md).

*loopCount*   \
Tipo: UINT32

Especifica el recuento de bucles.

### Valor devuelto

Tipo: HRESULT

Código HRESULT de éxito o de error.

## Comentarios

| Función | Descripción |
| - | - |
| PCM lineal sin bucle | Inicie la voz con la constante `SHAPE_SRC_COMMAND_TYPE_START` para el convertidor de frecuencia de muestreo (SRC). Deje que la voz se reproduzca hasta el final o, si lo desea, deténgala antes del final con la constante `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`. Para obtener más información, consulte la enumeración [SHAPE\_SRC\_COMMAND\_TYPE](https://docs.xbox.com/es/reference/audio/shapesrccontext/enums/shape_src_command_type.md). |
| PCM lineal con bucle infinito | Establezca el recuento de bucles del contexto de modulación por impulsos codificados (PCM) *loopCount* en la constante `SHAPE_PCM_INFINITE_LOOP_COUNT`. Inicie la voz con `SHAPE_SRC_COMMAND_TYPE_START` para el SRC. Deje que la voz se reproduzca hasta que quiera detenerla, ya sea al final de un bucle con `SHAPE_SRC_COMMAND_TYPE_STOP_END`, dejando que la voz termine de reproducirse, o inmediatamente con `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`. |
| PCM lineal con bucle finito | Establezca el recuento de bucles del contexto de PCM *loopCount* en \[0, 254]. Inicie la voz con `SHAPE_SRC_COMMAND_TYPE_START` para el SRC. Deje que la voz se reproduzca hasta el final o, si lo desea, deténgala al final de un bucle con `SHAPE_SRC_COMMAND_TYPE_STOP_END`, dejando que la voz termine de reproducirse, o deténgala inmediatamente con `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`. |
| PCM circular | Inicie la voz con `SHAPE_SRC_COMMAND_TYPE_START` para el SRC. Siga transmitiendo datos y actualizando el puntero de escritura del contexto de PCM hasta que quiera detenerla. Use `SHAPE_SRC_COMMAND_TYPE_STOP_END` para dejar que el SRC reproduzca hasta el puntero de escritura de PCM actual `loopStartWritePointer`, o `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE` para detenerla inmediatamente. |

## Requisitos

**Encabezado:** shapepcmcontext.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Información general sobre ACP](https://docs.xbox.com/es/build/console-features/audio/overviews/acp-overview.md)\
[Información general de SHAPE](https://docs.xbox.com/es/build/console-features/audio/overviews/shape-overview.md)\
[shapepcmcontext](https://docs.xbox.com/es/reference/audio/shapepcmcontext/shapepcmcontext_members.md)


## Related topics

- [ShapePcmContext](https://docs.xbox.com/es/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SetShapePcmLoopEnd](https://docs.xbox.com/es/reference/audio/shapepcmcontext/functions/setshapepcmloopend.md)
- [SetShapePcmLoopStartOrWritePointer](https://docs.xbox.com/es/reference/audio/shapepcmcontext/functions/setshapepcmloopstartorwritepointer.md)
- [GetShapePcmLoopCount](https://docs.xbox.com/es/reference/audio/shapepcmcontext/functions/getshapepcmloopcount.md)
- [SetShapePcmFormat](https://docs.xbox.com/es/reference/audio/shapepcmcontext/functions/setshapepcmformat.md)