XDspSubmitCommand
為指定的 XDSP 串流提交一個命令至硬體佇列。語法
參數
handle _In_類型:XDspStreamHandle 有效的 XDSP 串流控制代碼。 command _In_
類型:XDspCommand* XDspCommand 結構的指標。 commandSequence _Out_
類型:uint32_t* 用來傳回命令序列值的
uint32_t 指標。如需其他詳細資料,請參閱備註一節。
傳回值
類型:HRESULT 如果方法成功,會傳回 S_OK。如果方法失敗,會傳回下列代碼 (部分清單):備註
此呼叫速度很快,因為它不會配置資源或處理資料,只會將命令傳送至硬體伺服器。 此呼叫也會接受uint32_t 的指標,以傳回命令序列值 commandSequence,用於稍後追蹤命令結果何時就緒。此數字代表自工作階段開始且呼叫 XDspActivate 之後已成功提交的命令總數。第一個命令的此數字為 1,之後每次成功呼叫 XDspSubmitCommand 都會遞增 1。
如果硬體伺服器處於不良狀態,XDspSubmitCommand 將會傳回 XDSP_E_DEVICE_FATAL_ERROR 錯誤碼。此時,無法再為處於失敗狀態的 XDSP 串流提交任何命令。該串流的 XDspStatus 也會指出相同的錯誤。受影響的 XDSP 串流應透過檢查 XDspStatus 等待硬體處理所有已提交的命令,並在所有命令處理完畢後使用 XDspDeactivate 將其停用。其他 XDSP 串流不會受到影響,硬體會繼續處理其命令。
需求
標頭: XDspAudio.h 程式庫: Chad.lib 支援的平台: XBOX Series X|S概念文件
- XDSP Envelope 概觀
- 使用 XDSP API 進行含 Envelope 的單一串流 Convolution 的概觀
- 使用 XDSP API 進行單一串流 Convolution 的概觀
- XDSP 概觀
另請參閱
XDSPXDspSubmitCommandWithEnvelope
XDSP 錯誤
使用 XDSP API 進行單一串流 Convolution 的概觀
使用 XDSP API 進行單一串流 FFT/IFFT 的概觀
使用 XDSP API 進行含 Envelope 的單一串流 Convolution 的概觀