Platform SDK: DirectX

IDirectDraw7::GetDeviceIdentifier

The IDirectDraw7::GetDeviceIdentifier method obtains information about the driver. This method can be used, with caution, to recognize specific hardware installations to implement workarounds for poor driver or chipset behavior.

HRESULT GetDeviceIdentifier(
  LPDDDEVICEIDENTIFIER2 lpdddi,
  DWORD dwFlags
);

Parameters

lpdddi

Address of a DDDEVICEIDENTIFIER2 structure to receive information about the driver.

dwFlags

Flags specifying options. The following flag is defined:

DDGDI_GETHOSTIDENTIFIER: Causes the method to return information about the host (typically 2-D) adapter in a system equipped with a stacked secondary 3-D adapter. Such an adapter appears to the application as if it were part of the host adapter, but is typically located on a separate card. When the dwFlags parameter is 0, information on the stacked secondary is returned because this most accurately reflects the qualities of the DirectDraw object involved.

Return Values

If the method succeeds, the return value is DD_OK.

If it fails, the method can return DDERR_INVALIDPARAMS.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 98.
  Header: Declared in ddraw.h.