Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::GetDirect3D

デバイスを作成したMicrosoft® Direct3D® オブジェクトのインスタンスへのインターフェイスを返す。

HRESULT GetDirect3D(
  IDirect3D8** ppD3D8
);

パラメータ

ppD3D8
[out, retval] IDirect3D8 インターフェイスへのポインタのアドレス。デバイスを作成した Direct3D オブジェクトのインターフェイスを表す。

戻り値

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

失敗した場合は、D3DERR_INVALIDCALL を返す。

注意

GetDirect3D を呼び出すとそのインターフェイスに対する参照カウントが増えるので、インターフェイスの使用が終了したら、このポインタを通して IUnknown::Release を呼び出す必要がある。

  このメソッドを呼び出すと、IDirect3D8 インターフェイスについての内部参照カウントが増加する。この IDirect3D8 インターフェイスの使用を終了したときに IUnknown::Release の呼び出しが失敗すると、メモリ リークが発生する。

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。