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

# SetShapePcmLoopCount

> SetShapePcmLoopCount

# SetShapePcmLoopCount

ループカウントを設定します。

## 構文

```cpp theme={null}
HRESULT SetShapePcmLoopCount(  
         SHAPE_PCM_CONTEXT* context,  
         UINT32 loopCount  
)  
```

### パラメーター

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

[SHAPE\_PCM\_CONTEXT](/reference/audio/shapepcmcontext/structs/shape_pcm_context) 構造体へのポインター。

*loopCount*   \
型: UINT32

ループカウントを指定します。

### 戻り値

型: HRESULT

HRESULT の成功またはエラーコード。

## 解説

| 機能          | 説明                                                                                                                                                                                                                                                                                         |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 非ループ線形 PCM  | サンプルレートコンバーター (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` を使用して即座に停止します。                         |

## 要件

**ヘッダー:** shapepcmcontext.h

**サポート対象プラットフォーム:** XBOX One ファミリー本体および XBOX Series 本体

## 関連項目

[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](/ja-jp/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SetShapePcmLoopEnd](/ja-jp/reference/audio/shapepcmcontext/functions/setshapepcmloopend.md)
- [GetShapePcmLoopCount](/ja-jp/reference/audio/shapepcmcontext/functions/getshapepcmloopcount.md)
- [SetShapePcmLoopStartOrWritePointer](/ja-jp/reference/audio/shapepcmcontext/functions/setshapepcmloopstartorwritepointer.md)
- [SetShapePcmFormat](/ja-jp/reference/audio/shapepcmcontext/functions/setshapepcmformat.md)