IDirectDraw4::GetDeviceIdentifier

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

HRESULT GetDeviceIdentifier(
  LPDDDEVICEIDENTIFIER lpdddi,
  DWORD dwFlags
);
 

Parameters

lpdddi

Address of a DDDEVICEIDENTIFIER 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 zero, the stacked secondary's information 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 the method fails, the return value may be DDERR_INVALIDPARAMS.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in ddraw.h.
  Import Library: Use ddraw.lib.