Platform SDK: DirectX

D3DX_DEVICEDESC

The D3DX_DEVICEDESC structure describes a device that can render in 3-D.

typedef struct _D3DX_DEVICEDESC {
  DWORD       deviceIndex;
  DWORD       hwLevel;
  GUID        ddGuid;
  GUID        d3dDeviceGuid;
  GUID        ddDeviceID;
  char        driverDesc[D3DX_DRIVERDESC_LENGTH];
  HMONITOR    monitor;
  BOOL        onPrimary;
} D3DX_DEVICEDESC;

Members

deviceIndex: Unique number (DWORD) for the device.
hwLevel: Level of acceleration afforded. This is one of the predefined Device Indices, and exists in this structure for informational purposes only. More than one device on the system may have the same hwLevel. To refer to a particular device with the D3DX utility library, use the value in the deviceIndex member instead.
ddGuid: The DirectDraw globally unique identifier (GUID).
d3dDeviceGuid: The Direct3DDevice GUID.
ddDeviceID: The IDirectDraw7::GetDeviceIdentifier GUID. This GUID is unique to a particular driver revision on a particular video card.
driverDesc: String describing the driver. The maximum string length allowed is 256 characters.
monitor: Handle to the video monitor used by this device (multiple monitor specific). Devices that use different monitors on a multiple monitor system report different values in this field. Therefore, to test for a multiple monitor system, an application should look for more than one different monitor handle in the list of Direct3DX devices.
onPrimary: Indicates if this device is on the primary monitor (multiple monitor specific).

Remarks

The following statement defines the constant used by the driverDesc character array parameter:

#define D3DX_DRIVERDESC_LENGTH    256

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Version: Requires DirectX 7.0.
  Header: Declared in d3dxcore.h.