IDirect3DMobile::CreateDevice (Windows Embedded CE 6.0)

1/6/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

Header d3dm.h
Library D3dm.lib, D3dmguid.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

IDirect3DMobile
D3DMADAPTER Values
D3DMDEVTYPE
D3DMPRESENT_PARAMETERS