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

# GetShapePcmBufferLength

> GetShapePcmBufferLength

# GetShapePcmBufferLength

Obtiene la longitud del búfer de audio en muestras.

## Sintaxis

```cpp theme={null}
UINT32 GetShapePcmBufferLength(  
         const SHAPE_PCM_CONTEXT* context  
)  
```

### Parámetros

*context*   \_In\_\
Tipo: [SHAPE\_PCM\_CONTEXT\*](/reference/audio/shapepcmcontext/structs/shape_pcm_context)

Puntero a una estructura [SHAPE\_PCM\_CONTEXT](/reference/audio/shapepcmcontext/structs/shape_pcm_context).

### Valor devuelto

Tipo: UINT32

La longitud del búfer en muestras.

## Comentarios

El bloque del convertidor de frecuencia de muestreo (SRC) lee datos de modulación por impulsos codificados (PCM) de punto fijo de 16, 24 o 32 bits, o de punto flotante de 32 bits, desde la memoria del sistema y realiza una conversión de frecuencia de muestreo basada en enteros. Los datos de salida se escriben en búferes de mezcla. Como datos de entrada, el bloque SRC puede tomar la salida del descodificador de hardware XMA o datos mantenidos por software. El bloque SRC tiene una estrecha integración con el descodificador XMA. Esto permite que el bloque SRC determine si el búfer de descodificación XMA tiene suficientes muestras de datos PCM descodificados sin leer la memoria principal.

Un proceso de SRC se usa normalmente para la emulación de instrumentos musicales, la conversión de muestras de entrada a una octava más baja o más alta que el origen, o para efectos como el efecto Doppler.

El SRC opera en modo mono o estéreo. Los datos PCM se leen de la memoria y se convierten a un formato común de punto fijo de 24 bits para la conversión de frecuencia de muestreo. La salida se escribe en uno o dos búferes de mezcla según el modo. Los datos estéreo se almacenan en la memoria como una secuencia entrelazada de datos de 16 bits, con el canal izquierdo en los 16 bits menos significativos de cada palabra de 32 bits y el canal derecho en los 16 bits más significativos. En el modo estéreo, los datos PCM se leen y se desentrelazan simultáneamente. Los datos del canal izquierdo (muestras pares) se procesan y se envían a un búfer de mezcla, y los datos del canal derecho (muestras impares) se escriben en un segundo búfer de mezcla.

## Requisitos

**Encabezado:** shapepcmcontext.h

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

## Consulte también

[Información general sobre ACP](/build/console-features/audio/overviews/acp-overview)\
[Información general de Shape](/build/console-features/audio/overviews/shape-overview)\
[shapepcmcontext](/reference/audio/shapepcmcontext/shapepcmcontext_members)


## Related topics

- [ShapePcmContext](/es/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SetShapePcmBufferLength](/es/reference/audio/shapepcmcontext/functions/setshapepcmbufferlength.md)
- [GetShapePcmAudioBuffer](/es/reference/audio/shapepcmcontext/functions/getshapepcmaudiobuffer.md)
- [GetShapePcmBufferFull](/es/reference/audio/shapepcmcontext/functions/getshapepcmbufferfull.md)
- [SHAPE_PCM_CONTEXT](/es/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)