> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XDspSubmitCommand

> XDspSubmitCommand

# XDspSubmitCommand

指定された XDSP ストリームに対して、1 つのコマンドをハードウェア キューに送信します。

## 構文

```cpp theme={null}
HRESULT XDspSubmitCommand(  
         XDspStreamHandle handle,  
         XDspCommand* command,  
         uint32_t* commandSequence  
)  
```

### パラメーター

*handle*   \_In\_\
型: [XDspStreamHandle](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/handles/xdspstreamhandle.md)

有効な XDSP ストリーム ハンドル。

*command*   \_In\_\
型: [XDspCommand\*](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/structs/xdspcommand.md)

[XDspCommand](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/structs/xdspcommand.md) 構造体へのポインター。

*commandSequence*   \_Out\_\
型: uint32\_t\*

コマンド シーケンス値を返す `uint32_t` へのポインター。詳細については、**解説** セクションを参照してください。

### 戻り値

型: HRESULT

メソッドが成功した場合は S\_OK を返します。失敗した場合は次のコードを返します (一部の一覧):

| 戻りコード | 説明 |
| - | - |
| E\_INVALIDARG | 1 つ以上の引数が無効です。 |
| XDSP\_E\_QUEUE\_FULL | この呼び出しは、ストリームとハードウェア サーバーが最大処理容量に達した場合に XDSP\_E\_QUEUE\_FULL を返します。追加のコマンドを送信する前に、ハードウェアがコマンドを処理するのを待機してください。 |
| XDSP\_E\_DEVICE\_FATAL\_ERROR | ハードウェア サーバーが不良状態にある場合、**XDspSubmitCommand** は XDSP\_E\_DEVICE\_FATAL\_ERROR エラー コードを返します。 |

## 解説

この呼び出しは、リソースを割り当てたりデータを処理したりせず、コマンドをハードウェア サーバーに送信するだけなので、高速です。

この呼び出しは、後でコマンド結果の準備ができた時点を追跡するために、コマンド シーケンス値 *commandSequence* を返す `uint32_t` へのポインターも受け取ります。この数値は、セッションが開始され、[XDspActivate](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspactivate.md) が呼び出された後、正常に送信されたコマンドの合計数を表します。この数値は最初のコマンドで 1 になり、その後の正常な [XDspSubmitCommand](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspsubmitcommand.md) 呼び出しごとに 1 ずつ増加します。

ハードウェア サーバーが不良状態にある場合、**XDspSubmitCommand** は XDSP\_E\_DEVICE\_FATAL\_ERROR エラー コードを返します。この時点で、失敗状態にある XDSP ストリームに対してさらにコマンドを送信することはできません。ストリームの [XDspStatus](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/structs/xdspstatus.md) にも同じエラーが示されます。影響を受ける XDSP ストリームは、[XDspStatus](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/structs/xdspstatus.md) をチェックしてハードウェアが送信されたすべてのコマンドを処理するのを待機し、すべてのコマンドが処理されたら [XDspDeactivate](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspdeactivate.md) を使用して非アクティブ化する必要があります。他の XDSP ストリームは影響を受けず、ハードウェアはそれらのコマンドの処理を続行します。

## 要件

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

**ライブラリ:** Chad.lib

**サポートされるプラットフォーム:** XBOX Series X|S

## 概念ドキュメント

* [XDSP エンベロープの概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-enveloping.md)
* [XDSP API を使用したエンベロープ付き単一ストリーム畳み込みの概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
* [XDSP API を使用した単一ストリーム畳み込みの概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)
* [XDSP の概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview.md)

## 関連項目

[XDSP](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/xdspaudio_members.md)\
[XDspSubmitCommandWithEnvelope](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)\
[XDSP エラー](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/enums/xdsperrors.md)\
[XDSP API を使用した単一ストリーム畳み込みの概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)\
[XDSP API を使用した単一ストリーム FFT/IFFT の概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft.md)\
[XDSP API を使用したエンベロープ付き単一ストリーム畳み込みの概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)


## Related topics

- [XDspSubmitCommandWithEnvelope](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)
- [XDspCommand](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDspStreamHandle](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/handles/xdspstreamhandle.md)
- [XDSP エンベロープ処理の概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xdsp-overview-enveloping.md)
- [XDspStatus](https://docs.xbox.com/ja-jp/reference/audio/xdspaudio/structs/xdspstatus.md)