Platform SDK: DirectX |
Direct3DDevice7.Preload メソッドは、管理下のテクスチャをビデオ メモリにロードするよう Direct3D テクスチャ マネージャに指示する。
object.PreLoad( _ Texture As DirectDrawSurface7)
メソッドが失敗するとエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
このメソッドを使用すると、管理下のテキスチャが強制的にビデオ メモリにロードされるので、十分なビデオ メモリがない場合、システムはメモリを確保するために他のテクスチャを削除してから、指定されたテクスチャをロードする。ロードするテクスチャは、管理下のテクスチャ (DDSCAPS2_TEXTUREMANAGE または DDSCAPS2_D3DTEXTUREMANAGE フラグによって作成されたテクスチャ) でなければならない。これらの条件が満たされない場合は、メソッドが失敗し、DDERR_INVALIDPARAMS を返す。