IDirect3DMobile::CheckDeviceFormat (Windows CE 5.0)

Send Feedback

This method is used to determine if a specified pixel format is valid for a specified usage on a specified device. This includes formats for color buffers, depth buffers, and all other Direct3D Mobile resource types except vertex and index buffers.

HRESULT CheckDeviceFormat(  UINT Adapter,  D3DMDEVTYPE DeviceType,  D3DMFORMAT AdapterFormat,  ULONG Usage,  D3DMRESOURCETYPE RType,  D3DMFORMAT CheckFormat);

Parameters

  • Adapter
    [in] A value that indicates which device to provide information for. For possible values, see D3DMADAPTER Values.
  • DeviceType
    [in] A D3DMDEVTYPE enumeration value that specifies the type of device.
  • AdapterFormat
    [in] A legacy parameter provided for compatibility with older versions of Direct3D on Windows-based desktop systems. You must set this parameter to the D3DMFORMAT enumeration value for the current format of the display adapter.
  • Usage
    [in] A combination of D3DMUSAGE values that specifies the desired use for the resource specified by RType.
  • RType
    [in] A D3DMRESOURCETYPE enumeration value that specifies the type of resource to test the device for.
  • CheckFormat
    [in] A D3DMFORMAT enumeration value that specifies the pixel format to test the device for.

Return Values

This method returns D3DM_OK if the format is supported and D3DMERR_NOTAVAILABLE if it is not supported.

In addition, this method may also return D3DMERR_INVALIDCALL if it fails. For more information, see D3DMERR Values.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: D3dm.h.
Link Library: D3dm.lib, D3dmguid.lib.

See Also

IDirect3DMobile | D3DMADAPTER Values | D3DMDEVTYPE | D3DMFORMAT | D3DMUSAGE values | D3DMRESOURCETYPE

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.