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

# GetShapePcmReadPointer

> GetShapePcmReadPointer

# GetShapePcmReadPointer

읽기 포인터를 가져옵니다.

## Syntax

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

### Parameters

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

[SHAPE\_PCM\_CONTEXT](/reference/audio/shapepcmcontext/structs/shape_pcm_context) 구조체에 대한 포인터입니다.

### Return value

Type: UINT32

샘플 단위의 읽기 포인터를 지정합니다. 이 포인터는 두 개의 16비트 스테레오 샘플을 단일 32비트 샘플로 취급합니다.

## Remarks

Direct Memory Access(DMA) 명령의 차단을 방지하려면 오디오 버퍼를 충분히 크게 만들고 버퍼 크기에 맞는 일정한 간격으로 데이터를 스트리밍해야 합니다. 예를 들어 한 번에 4개의 하드웨어 프레임을 스트리밍하는 경우, 하드웨어가 타이틀의 읽기 포인터보다 앞서서 쓸 수 있도록 그 프레임 수의 배수(적어도 이중 버퍼링이 되는 8개)가 버퍼에 있도록 해야 합니다. 또는 다음 플로우그래프를 제출하기 전에 버퍼를 반드시 비우도록 강제할 수 있습니다(소비 후 DMA 읽기 포인터 업데이트, 그런 다음 플로우그래프 제출).

SRC에 대해 `SHAPE_SRC_COMMAND_TYPE_START` 상수를 사용하여 보이스를 시작합니다. 중지할 때까지 PCM 컨텍스트의 쓰기 포인터를 업데이트하며 데이터를 계속 스트리밍합니다. `SHAPE_SRC_COMMAND_TYPE_STOP_END` 상수를 사용하여 SRC가 현재 PCM 쓰기 포인터 `loopStartWritePointer`까지 재생하도록 하거나, `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`를 사용해 즉시 중지합니다. 자세한 내용은 [SHAPE\_SRC\_COMMAND\_TYPE](/reference/audio/shapesrccontext/enums/shape_src_command_type) 열거형을 참조하세요.

## Requirements

**Header:** shapepcmcontext.h

**Supported platforms:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## See also

[ACP 개요](/build/console-features/audio/overviews/acp-overview)\
[Shape 개요](/build/console-features/audio/overviews/shape-overview)\
[shapepcmcontext](/reference/audio/shapepcmcontext/shapepcmcontext_members)


## Related topics

- [ShapePcmContext](/ko/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SetShapePcmReadPointer](/ko/reference/audio/shapepcmcontext/functions/setshapepcmreadpointer.md)
- [GetShapePcmLoopStartOrWritePointer](/ko/reference/audio/shapepcmcontext/functions/getshapepcmloopstartorwritepointer.md)
- [GetShapeDmaReadPointer](/ko/reference/audio/shapedmacontext/functions/getshapedmareadpointer.md)
- [SHAPE_PCM_CONTEXT](/ko/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)