IDirect3DMobile::CreateDevice

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method is used to create a Direct3D Mobile device object and obtain a pointer to an IDirect3DMobileDevice interface to it.

Syntax

HRESULT CreateDevice(
  UINT Adapter,
  D3DMDEVTYPE DeviceType,
  HWND hFocusWindow,
  ULONG BehaviorFlags,
  D3DMPRESENT_PARAMETERS* pPresentationParameters,
  IDirect3DMobileDevice** ppReturnedDeviceInterface
);

Parameters

• Adapter
  [in] A value indicting which device to provide information for. For possible values, see D3DMADAPTER Values.

• DeviceType
  [in] A D3DMDEVTYPE enumeration value that specifies the type of device.

• hFocusWindow
  [in] An HWND value that is a handle to the window that will be the focus for Direct3D Mobile operations. This window remains the focus until the device object is destroyed. This can only be a window without a parent window.

• BehaviorFlags
  [in] A ULONG value to control the multithreading behavior of the device. To enable multithreading support, set this value to D3DMCREATE_MULTITHREADED.

• pPresentationParameters
  [in] A pointer to a D3DMPRESENT_PARAMETERS structure describing the properties of the swap that is implicitly created when the device is created.

• ppReturnedDeviceInterface
  [out] A pointer to the IDirect3DMobileDevice pointer for the device.

Return Value

If the device was created successfully, this method returns D3DM_OK. If the device was not created successfully, it returns one of the following error values:

• D3DMERR_INVALIDCALL
• D3DMERR_INVALIDDEVICE
• D3DMERR_NOTAVAILABLE
• E_OUTOFMEMORY

For more information, see D3DMERR Values.

Requirements

See Also

Reference

IDirect3DMobile
D3DMADAPTER Values
D3DMDEVTYPE
D3DMPRESENT_PARAMETERS