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

# GetShapePcmFormat

> GetShapePcmFormat

# GetShapePcmFormat

Obtiene el formato PCM.

## Sintaxis

```cpp theme={null}
SHAPE_PCM_FORMAT GetShapePcmFormat(  
         const SHAPE_PCM_CONTEXT* context  
)  
```

### Parámetros

*context*   \_In\_\
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).

### Valor devuelto

Tipo: SHAPE\_PCM\_FORMAT

Un miembro de la enumeración [SHAPE\_PCM\_FORMAT](https://docs.xbox.com/es/reference/audio/shapepcmcontext/enums/shape_pcm_format.md).

## Comentarios

| Función | Descripción |
| - | - |
| PCM lineal sin bucle | Inicie la voz con la constante `SHAPE_SRC_COMMAND_TYPE_START` del 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 *loopCount* del contexto de modulación por impulsos codificados (PCM) 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 emitiendo `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 *loopCount* del contexto PCM 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` y deje 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 PCM hasta que quiera detenerla. Use `SHAPE_SRC_COMMAND_TYPE_STOP_END` para dejar que el SRC reproduzca hasta el puntero de escritura PCM actual `loopStartWritePointer`, o `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE` para detenerla inmediatamente. |

Formatos de muestra de entrada:\\

![Diagrama que muestra las asignaciones de bits de cada uno de los cuatro formatos de muestra de entrada PCM admitidos.](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/pcm_format.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=58f4b6bb7fadd542a8c9a337cd729ba2)

## 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)
- [SHAPE_PCM_FORMAT](https://docs.xbox.com/es/reference/audio/shapepcmcontext/enums/shape_pcm_format.md)
- [SetShapePcmFormat](https://docs.xbox.com/es/reference/audio/shapepcmcontext/functions/setshapepcmformat.md)
- [GetShapePcmMode](https://docs.xbox.com/es/reference/audio/shapepcmcontext/functions/getshapepcmmode.md)
- [GetShapePcmLoopCount](https://docs.xbox.com/es/reference/audio/shapepcmcontext/functions/getshapepcmloopcount.md)
