Microsoft DirectX 8.0 (C++)

IDirectInputDevice8::EnumEffectsInFile

Force Editor ユーティリティや、同じファイル形式を使用する別のアプリケーションで作成されたファイルに含まれる、すべてのエフェクトを列挙する。

HRESULT EnumEffectsInFile(
  LPCSTR lpszFileName,
  LPENUMEFFECTSINFILECALLBACK pec, 
  LPVOID pvRef, 
  DWORD dwFlags
);

パラメータ

lpszFileName
RIFF ファイルの名前。
pec
アプリケーション定義のコールバック関数のアドレス。この関数の宣言は、DIEnumEffectsInFileCallback プロトタイプの宣言と同様に行わなければならない。
pvRef
コールバック関数に渡すアプリケーション定義の 32 ビットの値。このパラメータは、32 ビットの任意の値を取ることができる。
dwFlags
DIFEF_DEFAULT (= 0) あるいは以下の値の一方または両方を使用できる。
DIFEF_INCLUDENONSTANDARD
Microsoft® DirectInput® で定義されていないエフェクト タイプを含める。
DIFEF_MODIFYIFNEEDED
現在のデバイスで再生できるように、作成したエフェクトを必要に応じて変更するように DirectInput に対して指示する。たとえば、2 つの軸に対して作成されたエフェクトは、デフォルトでは単一軸デバイスでは再生されない。このフラグを設定すると、単一軸でそのようなエフェクトが再生される。パラメータは、DIEFFECT 構造体内で変更される。この構造体は、コールバックに渡される DIFILEEFFECT 構造体の lpDiEffect メンバにより参照される。

戻り値

成功した場合は、DI_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DIERR_INVALIDPARAM
DIERR_NOTINITIALIZED

コールバック関数が列挙を途中で停止すると、その列挙は成功したと見なされる。

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : dinput.h で宣言。

参照

IDirectInputDevice8::WriteEffectToFile、「ファイルからのエフェクトの読み込み