Direct3DResource8.PreLoad

Preloads a managed resource.

object.PreLoad()

Parts

object

Object expression that resolves to a Direct3DResource8 object.

Error Codes

If the method fails, an error is raised and Err.Number can be set to D3DERR_INVALIDCALL.

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

Applies To

This method applies to the following classes, which implement methods from Direct3DResource8.

• Direct3DBaseTexture8
• Direct3DCubeTexture8
• Direct3DIndexBuffer8
• Direct3DTexture8
• Direct3DVertexBuffer8
• Direct3DVolumeTexture8

Remarks

Calling this method indicates that the application will need this managed resource shortly. This method has no effect on nonmanaged resources.

PreLoad detects "thrashing" conditions where more resources are being used in each frame than can fit in video memory simultaneously. Under such circumstances Preload silently does nothing.