Direct3DCreate8

  • Article

This function creates an instance of a Direct3D8 object.

IDirect3D8* Direct3DCreate8(
  UINT SDKVersion
);

Parameters

  • SDKVersion
    Value of this parameter should be D3D_SDK_VERSION.

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 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 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

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

IDirect3D8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.