Platform SDK: DirectX

Direct3DDevice7.PreLoad

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

object.PreLoad( _ 
  Texture As DirectDrawSurface7)

パラメータ

object
Direct3DDevice7 オブジェクトを表すオブジェクト式。
Texture
メモリにロードされる DirectDrawSurface7 オブジェクトへの参照。

エラー コード

メソッドが失敗するとエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

注意

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

参照

自動テクスチャ管理