Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method retrieves information about the rendering device.

Syntax

HRESULT GetInfo(
  DWORD 
DevInfoID,
  void* 
pDevInfoStruct,
  DWORD 
DevInfoStructSize
);

Parameters

DevInfoID

[in] Value used to identify what information will be returned in pDevInfoStruct.

pDevInfoStruct

[in, out] Pointer to a structure that receives the specified device information if the call succeeds.

DevInfoStructSize

[in] Size of the structure at pDevInfoStruct, in bytes.

Return Value

If the method succeeds, the return value is D3DM_OK (see D3DM Values).

If the method fails, the return value can be D3DMERR_INVALIDCALL (see D3DMERR Values).

Remarks

Information returned by this method pertains to the underlying device driver. This method makes it possible for drivers to declare specific information types and corresponding structures that are not covered in the Windows Embedded CE documentation.

This method executes synchronously and can negatively impact an application's performance when it executes slowly. Do not call this method during scene rendering (between calls to IDirect3DMobileDevice::BeginSceneand IDirect3DMobileDevice::EndScene).

This method is intended to be used for performance tracking and debugging during product development when using Direct3D Mobile middleware built for a debug configuration. The method can succeed, returning S_FALSE, without retrieving device data. This occurs when the using Direct3D Mobile middle ware built for a release configuration.

Requirements

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

See Also