IDirectInputEffectDriver::SendForceFeedbackCommand 方法 (dinputd.h)
IDirectInputEffectDriver::SendForceFeedbackCommand 方法會變更裝置的強制回饋狀態。
語法
HRESULT SendForceFeedbackCommand(
DWORD unnamedParam1,
DWORD unnamedParam2
);
參數
unnamedParam1
指出要尋址的外部遊戲桿編號。
unnamedParam2
指出正在傳送下列哪一個命令:
DISFFC_RESET
指出應該停止播放任何作用中效果,而且所有效果都應該從裝置中移除。 重設裝置之後,所有效果都不再有效,而且必須重新建立。
DISFFC_STOPALL
表示應該停止播放所有效果。 傳送DISFFC_STOPALL命令相當於對正在播放的所有效果叫用 IDirectInputEffect::Stop 方法。 如果裝置處於暫停狀態,則允許裝置驅動程式失去暫停狀態。
DISFFC_PAUSE
表示應該暫停播放所有效果。 當效果暫停時,時間會「停止」,直到傳送DISFFC_CONTINUE命令為止。 例如,假設已啟動五秒持續時間的效果。 一秒之後,所有效果都會暫停。 兩秒之後,所有效果都會繼續。 然後效果應該會播放四個額外的秒。 當強制回饋裝置暫停時,啟動新的效果或修改現有的效果可能會導致暫停狀態遺失。
DISFFC_CONTINUE
表示播放應該在先前的 DISFFC_PAUSE 命令暫停的效果中斷時繼續播放。
DISFFC_SETACTUATORSON
指出應啟用裝置的強制回饋器。
DISFFC_SETACTUATORSOFF
表示應停用裝置的強制回饋器。 如果成功,強制意見反應效果會「靜音」。 請注意,當閥關閉時,時間會繼續經過。 例如,假設已啟動五秒的持續時間效果。 一秒之後,就會關閉閥。 兩秒之後,就會重新開啟閥。 然後效果應該會播放兩秒。
傳回值
如果成功,則傳回S_OK;否則,傳回錯誤碼。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | dinputd.h (include Dinputd.h) |