Direct3DCreate8

Creates an instance of a Direct3D8 object.

IDirect3D8* Direct3DCreate8(
  UINT SDKVersion
);

Parameters

SDKVersion

The value of this parameter should be D3D_SDK_VERSION. See Remarks.

Return Values

If successful, this function returns a pointer to an IDirect3D8 interface; otherwise, a NULL pointer is returned.

Remarks

This function creates a Direct3D8 object that supports enumeration and allows the creation of Direct3DDevice8 objects.

The D3D_SDK_VERSION identifier is passed to Direct3DCreate8 in order to ensure that an application was built against the correct header files. This value is incremented whenever a header or other change would require applications to be rebuilt. If the version does not match, Direct3DCreate8 will fail.

Note that calling this function samples the current set of active display adapters. If the user dynamically adds adapters, either by adding devices to the desktop or by hot-docking a laptop, then those devices will not be enumerated for the lifetime of this Direct3D8 object. Creating a new Direct3D8 object will expose the new devices.

Requirements

  Header: Declared in D3d8.h.
  Import Library: Use D3d8.lib