Microsoft DirectX 8.0 (C++) |
デバイス上のフォース フィードバック システムがサポートするエフェクトをすべて列挙する。列挙される GUID は、デバイス メーカー独自のエフェクトに加えて、事前定義されたエフェクトも表すことができる。
HRESULT EnumEffects( LPDIENUMEFFECTSCALLBACK lpCallback, LPVOID pvRef, DWORD dwEffType );
成功した場合は、DI_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
DIERR_INVALIDPARAM |
DIERR_NOTINITIALIZED |
コールバック関数が列挙を途中で停止すると、その列挙は成功したと見なされる。
アプリケーションは、DIEFFECTINFO 構造体の dwEffType メンバを使用して、エフェクトのタイプ、エフェクトがサポートしているエンベロープと条件パラメータが何であるか、などエフェクトの一般的情報を取得できる。
エフェクトを最大限に利用するには、デバイス メーカーに問い合わせて、エフェクトの意味内容とそのエフェクト固有のパラメータに関する情報を入手しなければならない。
Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
ヘッダー : dinput.h で宣言。