XDspSubmitCommand
指定された XDSP ストリームに対して、1 つのコマンドをハードウェア キューに送信します。構文
パラメーター
handle _In_型: XDspStreamHandle 有効な XDSP ストリーム ハンドル。 command _In_
型: XDspCommand* XDspCommand 構造体へのポインター。 commandSequence _Out_
型: uint32_t* コマンド シーケンス値を返す
uint32_t へのポインター。詳細については、解説 セクションを参照してください。
戻り値
型: HRESULT メソッドが成功した場合は S_OK を返します。失敗した場合は次のコードを返します (一部の一覧):解説
この呼び出しは、リソースを割り当てたりデータを処理したりせず、コマンドをハードウェア サーバーに送信するだけなので、高速です。 この呼び出しは、後でコマンド結果の準備ができた時点を追跡するために、コマンド シーケンス値 commandSequence を返すuint32_t へのポインターも受け取ります。この数値は、セッションが開始され、XDspActivate が呼び出された後、正常に送信されたコマンドの合計数を表します。この数値は最初のコマンドで 1 になり、その後の正常な XDspSubmitCommand 呼び出しごとに 1 ずつ増加します。
ハードウェア サーバーが不良状態にある場合、XDspSubmitCommand は XDSP_E_DEVICE_FATAL_ERROR エラー コードを返します。この時点で、失敗状態にある XDSP ストリームに対してさらにコマンドを送信することはできません。ストリームの XDspStatus にも同じエラーが示されます。影響を受ける XDSP ストリームは、XDspStatus をチェックしてハードウェアが送信されたすべてのコマンドを処理するのを待機し、すべてのコマンドが処理されたら XDspDeactivate を使用して非アクティブ化する必要があります。他の XDSP ストリームは影響を受けず、ハードウェアはそれらのコマンドの処理を続行します。
要件
ヘッダー: XDspAudio.h ライブラリ: Chad.lib サポートされるプラットフォーム: XBOX Series X|S概念ドキュメント
関連項目
XDSPXDspSubmitCommandWithEnvelope
XDSP エラー
XDSP API を使用した単一ストリーム畳み込みの概要
XDSP API を使用した単一ストリーム FFT/IFFT の概要
XDSP API を使用したエンベロープ付き単一ストリーム畳み込みの概要