Win32 API 日本語リファレンス
ホームDevices.HumanInterfaceDevice › IDirectInputEffectDriver

IDirectInputEffectDriver

COM
IID02538130-898f-11d0-9ad0-00a0c9a06e35継承元IUnknown自前メソッド開始 vtbl3

メソッド 11

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT DeviceID(DWORD param0, DWORD param1, DWORD param2, DWORD param3, void* param4)
param0DWORDin対象デバイスの外部識別子(外部ID)。
param1DWORDinデバイスの新規割り当てか解放かを示すフラグ。
param2DWORDin内部デバイスID。ドライバ内でデバイスを識別する番号。
param3DWORDinデバイスの種別やプラグイン番号を示す値。
param4void*inoutデバイス固有情報を格納したバッファへのポインタ。NULL可。
vtbl 4 HRESULT GetVersions(DIDRIVERVERSIONS* param0)
param0DIDRIVERVERSIONS*inoutドライバとファームウェアのバージョン情報を受け取るDIDRIVERVERSIONS構造体へのポインタ。
vtbl 5 HRESULT Escape(DWORD param0, DWORD param1, DIEFFESCAPE* param2)
param0DWORDin対象デバイスの内部ID。
param1DWORDin対象エフェクトのドライバ内識別子。
param2DIEFFESCAPE*inoutドライバ固有拡張コマンドを格納したDIEFFESCAPE構造体へのポインタ。
vtbl 6 HRESULT SetGain(DWORD param0, DWORD param1)
param0DWORDin対象デバイスの内部ID。
param1DWORDinデバイス全体のゲイン値。0〜10000の範囲で指定する。
vtbl 7 HRESULT SendForceFeedbackCommand(DWORD param0, DWORD param1)
param0DWORDin対象デバイスの内部ID。
param1DWORDin送信するFFコマンドフラグ。DISFFC_RESET/DISFFC_STOPALL等。
vtbl 8 HRESULT GetForceFeedbackState(DWORD param0, DIDEVICESTATE* param1)
param0DWORDin対象デバイスの内部ID。
param1DIDEVICESTATE*inoutFF状態を受け取るDIDEVICESTATE構造体へのポインタ。
vtbl 9 HRESULT DownloadEffect(DWORD param0, DWORD param1, DWORD* param2, DIEFFECT* param3, DWORD param4)
param0DWORDin対象デバイスの内部ID。
param1DWORDinエフェクト種別を示す値。
param2DWORD*inout入出力。ダウンロード先エフェクトのドライバ内IDを受け渡すポインタ。0で新規割り当て。
param3DIEFFECT*inoutダウンロードするエフェクトのパラメータを格納したDIEFFECT構造体へのポインタ。
param4DWORDin更新範囲を示すフラグ。DIEP_*値の組み合わせを指定する。
vtbl 10 HRESULT DestroyEffect(DWORD param0, DWORD param1)
param0DWORDin対象デバイスの内部ID。
param1DWORDin破棄するエフェクトのドライバ内ID。
vtbl 11 HRESULT StartEffect(DWORD param0, DWORD param1, DWORD param2, DWORD param3)
param0DWORDin対象デバイスの内部ID。
param1DWORDin開始するエフェクトのドライバ内ID。
param2DWORDin動作モードフラグ。DIES_SOLO等を指定する。
param3DWORDin再生する反復回数。INFINITEで無限再生。
vtbl 12 HRESULT StopEffect(DWORD param0, DWORD param1)
param0DWORDin対象デバイスの内部ID。
param1DWORDin停止するエフェクトのドライバ内ID。
vtbl 13 HRESULT GetEffectStatus(DWORD param0, DWORD param1, DWORD* param2)
param0DWORDin対象デバイスの内部ID。
param1DWORDin状態を取得するエフェクトのドライバ内ID。
param2DWORD*inoutエフェクトの状態フラグを受け取るDWORDへのポインタ。DIEGES_PLAYING等を返す。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_IDirectInputEffectDriver "{02538130-898F-11D0-9AD0-00A0C9A06E35}"
#usecom global IDirectInputEffectDriver IID_IDirectInputEffectDriver "{}"
#comfunc global IDirectInputEffectDriver_DeviceID                  3 int,int,int,int,sptr
#comfunc global IDirectInputEffectDriver_GetVersions               4 var
#comfunc global IDirectInputEffectDriver_Escape                    5 int,int,var
#comfunc global IDirectInputEffectDriver_SetGain                   6 int,int
#comfunc global IDirectInputEffectDriver_SendForceFeedbackCommand  7 int,int
#comfunc global IDirectInputEffectDriver_GetForceFeedbackState     8 int,var
#comfunc global IDirectInputEffectDriver_DownloadEffect            9 int,int,var,var,int
#comfunc global IDirectInputEffectDriver_DestroyEffect             10 int,int
#comfunc global IDirectInputEffectDriver_StartEffect               11 int,int,int,int
#comfunc global IDirectInputEffectDriver_StopEffect                12 int,int
#comfunc global IDirectInputEffectDriver_GetEffectStatus           13 int,int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。