Microsoft DirectX 8.1 (C++)

Surfaces

A surface represents a linear area of display memory. A surface usually resides in the display memory of the display card, although surfaces can exist in system memory. Surface objects are contained within the IDirect3DSurface8 interface.

An IDirect3DSurface8 interface is obtained by calling one of the following methods.

The IDirect3DSurface8 interface enables you to indirectly access memory through the IDirect3DDevice8::CopyRects method. This method allows you to copy a rectangular region of pixels from one IDirect3DSurface8 interface to another IDirect3DSurface8 interface. The surface interface also has methods to directly access display memory. For example, you can use the IDirect3DSurface8::LockRect method to lock a rectangular region of display memory. It is important to call IDirect3DSurface8::UnlockRect after you are done working with the locked rectangular region on the surface.

Surface formats dictate how data for each pixel in surface memory is interpreted. Microsoft® Direct3D® uses the D3DFORMAT member of the D3DSURFACE_DESC structure to describe the surface format. You can retrieve the format of an existing surface by calling the IDirect3DSurface8::GetDesc method.

Additional information can be found in the following topics.