Direct3DMobileCreate (Windows Embedded CE 6.0)

1/6/2010

This function creates the Direct3D Mobile object that supports the IDirect3DMobile interface.

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 IDirect3DMobile interface for the application.

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

Remarks

An application starts Direct3D Mobile by calling Direct3DMobileCreate to 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 Direct3DMobile will fail.

If the call to Direct3DMobile succeeds, 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

See Also

Reference

Direct3D Mobile Functions