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

# SetShapePcmReadPointer

> SetShapePcmReadPointer

# SetShapePcmReadPointer

Establece el puntero de lectura.

## Sintaxis

```cpp theme={null}
HRESULT SetShapePcmReadPointer(  
         SHAPE_PCM_CONTEXT* context,  
         UINT32 readPointerInSamples  
)  
```

### Parámetros

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




*readPointerInSamples*   \
Tipo: UINT32

Puntero de lectura en muestras. Este puntero trata dos muestras estéreo de 16 bits como una única muestra de 32 bits.

### Valor devuelto

Tipo: HRESULT

Código HRESULT de éxito o de error.

## Comentarios

Puede evitar los comandos de acceso directo a memoria (DMA) bloqueados asegurándose de que el búfer de audio sea lo suficientemente grande y de que los datos se transmitan a intervalos regulares relacionados con el tamaño del búfer. Por ejemplo, si transmite cuatro fotogramas de hardware a la vez, asegúrese de que haya algún múltiplo de esos fotogramas en el búfer (al menos con doble búfer, es decir, ocho) para que el hardware pueda escribir por delante del puntero de lectura del título. Como alternativa, puede exigir que el búfer se vacíe antes de enviar el siguiente grafo de flujo (consumir, actualizar el puntero de lectura de DMA y, a continuación, enviar el grafo de flujo).

Inicie la voz con la constante `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 la constante `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. Para obtener más información, consulte la enumeración [SHAPE\_SRC\_COMMAND\_TYPE](/reference/audio/shapesrccontext/enums/shape_src_command_type).

## 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)
- [GetShapePcmReadPointer](/es/reference/audio/shapepcmcontext/functions/getshapepcmreadpointer.md)
- [SetShapePcmLoopStartOrWritePointer](/es/reference/audio/shapepcmcontext/functions/setshapepcmloopstartorwritepointer.md)
- [SetShapeDmaReadPointer](/es/reference/audio/shapedmacontext/functions/setshapedmareadpointer.md)
- [SHAPE_PCM_CONTEXT](/es/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)