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

# SetShapePcmFormat

> SetShapePcmFormat

# SetShapePcmFormat

PCM 형식을 설정합니다.

## Syntax

```cpp theme={null}
HRESULT SetShapePcmFormat(  
         SHAPE_PCM_CONTEXT* context,  
         SHAPE_PCM_FORMAT format  
)  
```

### Parameters

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

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

*format*   \
Type: [SHAPE\_PCM\_FORMAT](/reference/audio/shapepcmcontext/enums/shape_pcm_format)

[SHAPE\_PCM\_FORMAT](/reference/audio/shapepcmcontext/enums/shape_pcm_format) 열거형의 멤버 중 하나입니다.

### 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 | 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`를 사용해 즉시 중지합니다.                    |

입력 샘플 형식:\\

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/pcm_format.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=58f4b6bb7fadd542a8c9a337cd729ba2" alt="지원되는 4가지 PCM 입력 샘플 형식 각각에 대한 비트 배치를 보여주는 다이어그램." width="740" height="357" data-path="images/gdk/reference/pcm_format.png" />

## 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)
- [SHAPE_PCM_FORMAT](/ko/reference/audio/shapepcmcontext/enums/shape_pcm_format.md)
- [GetShapePcmFormat](/ko/reference/audio/shapepcmcontext/functions/getshapepcmformat.md)
- [SetShapePcmMode](/ko/reference/audio/shapepcmcontext/functions/setshapepcmmode.md)
- [SetShapePcmLoopCount](/ko/reference/audio/shapepcmcontext/functions/setshapepcmloopcount.md)