Skip to main content

​
XApuEnqueueCommand

將單一命令提交至 XAPU 命令佇列。

​
語法

​
參數

handle   _In_
類型: XApuHandle 呼叫 XApuConnect 所傳回的控制代碼。 command   _In_
類型: XApuCommandId* 要提交至 XAPU 輸入佇列的命令。 totalCommandCount   _Out_opt_
類型: uint32_t* 傳回的命令總數。

​
傳回值

類型: HRESULT 如果成功，會傳回 S_OK；否則會傳回錯誤碼。

​
備註

此呼叫速度很快，因為它不會配置資源或處理資料，只會將命令傳送至硬體伺服器。如果有 XApuConnectInputParameters::maxQueuedCommandsPerStream 個命令正在處理中，此呼叫會傳回 XAPU_E_QUEUE_FULL。若要避免此錯誤，呼叫端必須透過 XApuDequeueResult 擷取一或多個結果。此呼叫是安全執行緒，也就是說可以從多個執行緒提交命令，不過從多個執行緒呼叫它並沒有效能上的優勢。 此呼叫也會接受 uint32_t 的指標，以傳回目前工作階段的 totalCommandCount。此數字代表自工作階段開始並呼叫 XApuConnect 之後，已成功提交的命令總數。此數字不會歸零。 如果硬體伺服器處於不良狀態，XApuEnqueueCommand 會傳回 XAPU_E_DEVICE_FATAL_ERROR 錯誤碼。在此情況下，所有 XAPU 用戶端都應中斷連線，然後重新連線。 如果此方法失敗，會傳回描述性的錯誤碼。 下表將每個 XApuCommandType 對應至應傳遞給 XApuEnqueueCommand 的結構類型:

​
需求

標頭: xapu.h 程式庫: xapu.lib 支援的平台: XBOX Series X|S

​
另請參閱

XAPU
Last modified on October 6, 2026