Direct3DMobileCreate
A version of this page is also available for
4/8/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
| Header | d3dm.h |
| Library | D3dm.lib |
| Windows Embedded CE | Windows CE 5.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |