Platform SDK: DirectX

IDirectInputDevice7::EnumCreatedEffectObjects

IDirectInputDevice7::EnumCreatedEffectObjects メソッドは、このデバイスに現在作成されているすべてのエフェクトを列挙する。IDirectInputDevice7::CreateEffect によって作成されたエフェクトが列挙される。

HRESULT EnumCreatedEffectObjects(
  LPDIENUMCREATEDEFFECTOBJECTSCALLBACK lpCallback,  
  LPVOID pvRef,                                     
  DWORD fl                                          
);

パラメータ

lpCallback
アプリケーション定義のコールバック関数のアドレス。DirectInput は、プロトタイプ関数 DIEnumCreatedEffectObjectsCallback を提供している。
pvRef
コールバック用のリファレンス データ (コンテキスト)
fl
フラグは現在未定義である。このパラメータは、ゼロでなければならない。

戻り値

成功すれば DI_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

DIERR_INVALIDPARAM
DIERR_NOTINITIALIZED

注意

列挙の進行中に、エフェクトを作成または廃棄すると、その結果は予測できない。しかし、コールバック関数は、渡されるエフェクトを確実に解放する。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dinput.h で宣言。
  インポート ライブラリ : dinput.lib を使用。