Platform SDK: DirectX

IDirect3DDevice7::PreLoad

IDirect3DDevice7::Preload メソッドは、Direct3D テクスチャ マネージャに管理下のテクスチャをビデオ メモリにロードするよう指示する。

HRESULT PreLoad(
  LPDIRECTDRAWSURFACE7 lpddsTexture
);

パラメータ

lpddsTexture
メモリにロードするテクスチャの IDirectDrawSurface7 インターフェイスのアドレス。

戻り値

成功すれば D3D_OK を返す。

失敗すれば、次のいずれかの値を返す。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

注意

このメソッドは、管理下のテクスチャをビデオ メモリに強制的にロードする。使用できるビデオ メモリが十分にない場合、システムはその他のテクスチャを削除してメモリを確保した後、テクスチャをロードする。ロードするテクスチャは管理下のテクスチャでなければならない (DDSCAPS2_TEXTUREMANAGE または DDSCAPS2_D3DTEXTUREMANAGE フラグで作成されたもの)。これ以外の場合には、メソッドは失敗し、DDERR_INVALIDPARAMS を返す。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  バージョン :DirectX 7.0 が必要。
  ヘッダー : d3d.h で宣言。

参照

自動テクスチャ管理