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

# SetShapePcmLoopStartOrWritePointer

> SetShapePcmLoopStartOrWritePointer

# SetShapePcmLoopStartOrWritePointer

선형 버퍼의 경우 루프 시작 지점을, 순환 버퍼의 경우 쓰기 포인터를 설정합니다.

## Syntax

```cpp theme={null}
HRESULT SetShapePcmLoopStartOrWritePointer(  
         SHAPE_PCM_CONTEXT* context,  
         UINT32 loopStartOrWritePointerInSamples  
)  
```

### Parameters

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

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

*loopStartOrWritePointerInSamples*   \
Type: UINT32

루프 시작 지점 또는 쓰기 포인터를 지정합니다.

### Return value

Type: HRESULT

HRESULT 성공 또는 오류 코드입니다.

## Remarks

| Function     | Description                                                                                                                                                                                                                                                                                   |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 비반복 선형 PCM   | Sample Rate Convertor(SRC)의 `SHAPE_SRC_COMMAND_TYPE_START` 상수를 사용하여 보이스를 시작합니다. 보이스가 끝까지 재생되도록 두거나, `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE` 상수를 사용해 도중에 중지할 수 있습니다. 자세한 내용은 [SHAPE\_SRC\_COMMAND\_TYPE](/reference/audio/shapesrccontext/enums/shape_src_command_type) 열거형을 참조하세요.            |
| 무한 반복 선형 PCM | Pulse Code Modulation(PCM) 컨텍스트의 반복 횟수 *loopCount*를 `SHAPE_PCM_INFINITE_LOOP_COUNT` 상수로 설정합니다. SRC에 대해 `SHAPE_SRC_COMMAND_TYPE_START`를 사용해 보이스를 시작합니다. 원하는 시점까지 보이스를 재생시키다가, 루프 끝에서 `SHAPE_SRC_COMMAND_TYPE_STOP_END`를 사용해 재생을 마무리하거나, `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`를 사용해 즉시 중지합니다. |
| 유한 반복 선형 PCM | PCM 컨텍스트의 반복 횟수 *loopCount*를 \[0, 254] 범위로 설정합니다. SRC에 대해 `SHAPE_SRC_COMMAND_TYPE_START`를 사용해 보이스를 시작합니다. 보이스가 끝까지 재생되도록 두거나, 선택적으로 `SHAPE_SRC_COMMAND_TYPE_STOP_END`를 사용해 루프 끝에서 재생을 마무리하거나, `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`를 사용해 즉시 중지합니다.                                          |
| 순환 PCM       | SRC에 대해 `SHAPE_SRC_COMMAND_TYPE_START`를 사용해 보이스를 시작합니다. 중지할 때까지 PCM 컨텍스트의 쓰기 포인터를 업데이트하며 데이터를 계속 스트리밍합니다. `SHAPE_SRC_COMMAND_TYPE_STOP_END`를 사용해 SRC가 현재 PCM 쓰기 포인터 `loopStartWritePointer`까지 재생하도록 하거나, `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE`를 사용해 즉시 중지합니다.                               |

## 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)
- [GetShapePcmLoopStartOrWritePointer](/ko/reference/audio/shapepcmcontext/functions/getshapepcmloopstartorwritepointer.md)
- [SHAPE_PCM_CONTEXT](/ko/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)
- [SetShapePcmLoopCount](/ko/reference/audio/shapepcmcontext/functions/setshapepcmloopcount.md)
- [SetShapePcmLoopEnd](/ko/reference/audio/shapepcmcontext/functions/setshapepcmloopend.md)