Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function creates the Direct3D Mobile object that supports the IDirect3DMobileinterface.

Syntax 

IDirect3DMobile* WINAPI Direct3DMobileCreate(
  UINT 
SDKVersion
);

Parameters

SDKVersion

[in] A value that is passed to this function to ensure that the header files against which an application is compiled match the version of the runtime DLL that is installed on the target device.

Applications should specify the value D3DM_SDK_VERSION for this parameter.

Return Value

If the call is successful, the function returns a pointer to the IDirect3DMobileinterface for the application.

A NULL return value indicates failure. To obtain extended error information, call the GetLastErrorfunction.

Remarks

An application starts Direct3D Mobile by calling Direct3DMobileCreateto create a Driect3D Mobile object. This function verifies that the version of Direct3D Mobile that the application was compiled against is compatible with the Direct3D Mobile libraries in the OS.

Direct3DMobileCreate also checks to ensure that the calling application is the only Direct3D Mobile application currently running on the system. If another Direct3D Mobile application is already running, the call to Direct3DMobilewill fail.

If the call to Direct3DMobilesucceeds, the Direct3DMobileCreate API creates a new object that implements the IDirect3DMobile interface and returns a pointer to that interface for the application to use.

Requirements

Header d3dm.h
Library D3dm.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also