Platform SDK: DirectX

IDirectInputDevice7::GetEffectInfo

IDirectInputDevice7::GetEffectInfo メソッドは、エフェクトに関する情報を取得する。

HRESULT GetEffectInfo(
  LPDIEFFECTINFO pdei,  
  REFGUID rguid         
);

パラメータ

pdei
エフェクトの情報を受け取る DIEFFECTINFO 構造体。呼び出し側は、このメソッドを呼び出す前に、この構造体の dwSize メンバを初期化しておかなければならない。
rguid
情報を要求するエフェクトの識別子。

戻り値

成功すれば DI_OK を返す。

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

DIERR_DEVICENOTREG
DIERR_INVALIDPARAM
DIERR_NOTINITIALIZED

注意

C++ では、rguid パラメータは参照値として渡さなければならない。C では参照値として渡すことができないので、アドレスとして渡さなければならない。次は、C++ での呼び出し例である。

lpdev2->GetEffectInfo(&dei, GUID_Effect);

次は、C での同じ呼び出し例である。

lpdev2->lpVtbl->GetEffectInfo(lpdev2, &dei, &GUID_Effect);

動作環境

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