Platform SDK: DirectX

IDirect3D7

Applications use the methods of the IDirect3D7 interface to create Direct3D objects and set up the environment. This section is a reference to the methods of this interface. For a conceptual overview, see Direct3D Interfaces.

The IDirect3D7 interface is obtained by calling the QueryInterface method from a DirectDraw object.

The methods of the IDirect3D7 interface can be organized into the following groups:

Creation CreateDevice
  CreateVertexBuffer
Enumeration EnumDevices
  EnumZBufferFormats
Miscellaneous EvictManagedTextures

The IDirect3D7 interface simplifies the IDirect3D3 interface by eliminating the need for creation methods for objects other than devices and vertex buffers. In contrast to the IDirect3D3 interface, the IDirect3D3::CreateLight, IDirect3D3::CreateMaterial, and IDirect3D3::CreateViewport methods are not present in IDirect3D7. The functionality provided by these methods is now offered by the IDirect3DDevice7 interface.

The IDirect3D7 interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:

IUnknown AddRef
  QueryInterface
Release

The LPDIRECT3D7, LPDIRECT3D3, LPDIRECT3D2, and LPDIRECT3D types are defined as pointers to the IDirect3D7, IDirect3D3, IDirect3D2, and IDirect3D interfaces:

typedef struct IDirect3D    *LPDIRECT3D;
typedef struct IDirect3D2   *LPDIRECT3D2;
typedef struct IDirect3D3   *LPDIRECT3D3;
typedef struct IDirect3D7   *LPDIRECT3D7;

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Version: Requires DirectX 7.0.
  Header: Declared in d3d.h.

See Also

Accessing Direct3D, Direct3D and DirectDraw