Edit

Manipulating Resources (Direct3D 9)

  • Article

Your application manipulates resources in order to render a scene. First, an application needs to create a texture resource with one of the following methods:

A texture resource can instead be created with one of the D3DXCreatexxx texturing functions.

The texture objects returned by the texture creation methods are containers for surfaces or volumes; these containers are generically known as buffers. The buffers owned by the resource inherit the usages, format, and pool of the resource but have their own type. For more information, see Resource Properties (Direct3D 9).

The application gains access to the contained surfaces, for the purpose of loading artwork, by calling the following methods. For details, see Locking Resources (Direct3D 9).

The lock methods take arguments denoting the contained surface - for example, the mipmap sub-level or cube face of the texture - and return pointers to the pixels. The typical application never uses a surface object directly.

Create geometry-oriented resources by calling IDirect3DDevice9::CreateIndexBuffer or IDirect3DDevice9::CreateVertexBuffer.

Lock and fill the buffer resources by calling either IDirect3DIndexBuffer9::Lock or IDirect3DVertexBuffer9::Lock, depending upon the resource.

For managed texture resources, the resource creation process ends here. For non-managed texture resources, an application promotes system memory resources to device-accessible resources (for hardware acceleration) by calling IDirect3DDevice9::UpdateTexture.

To present images rendered from resources, the application also needs color and depth-stencil buffers. For typical applications, the color buffer is owned by the device's swap chain, which is a collection of back-buffer surfaces, and is implicitly created with the device. Depth-stencil surfaces can be implicitly created, or explicitly created by using the IDirect3DDevice9::CreateDepthStencilSurface method. The application associates a device and its depth and color buffer with a call to IDirect3DDevice9::SetRenderTarget or IDirect3DDevice9::SetDepthStencilSurface.

For details on presenting the final image, see Presenting a Scene (Direct3D 9).

Direct3D Resources