DISPLAYINFO


DISPLAYINFO  struc
  diHdrSize    dw  size DisplayInfo
  diInfoFlags    dw  ?
  diDevNodeHandle    dd  ?
  diDriverName    db  16 dup(?)
  diXRes      dw  ?
  diYRes      dw  ?
  diDPI      dw  ?
  diPlanes    db  ?
  diBpp      db  ?
  diRefreshRateMax  dw  ?
  diRefreshRateMin  dw  ?
  diLowHorz    dw  ?
  diHighHorz    dw  ?
  diLowVert    dw  ?
  diHighVert    dw  ?
  diMonitorDevNodeHandle  dd  ?
  diHorzSyncPolarity  db  ?
  diVertSyncPolarity  db  ?
DISPLAYINFO

Specifies the display information selected by the user. The information in this structure is obtained by calling either the ring 3 function VDD_GET_DISPLAY_CONFIG or the ring 0 function VDD_GetDisplayInfo.

diHdrSize

Size in bytes of the DISPLAYINFO structure.

diInfoFlags

Informational flags, may be one of the following:

RETURNED_DATA_IS_STALE

Indicates that the data in the DISPLAYINFO structure was read in a previous call to VDD_GET_DISPLAY_CONFIG instead of directly from the Registry. If this flag is set, you may want to call VDD_GET_DISPLAY_CONFIG (or VDD_GetDisplayInfo) again to attempt to obtain data directly from the registry.

MINIVDD_FAILED_TO_LOAD

Indicates that the mini-VDD did not load, possibly because the mini-VDD did not match the chipset installed in the machine.

MINIVDD_CHIP_ID_DIDNT_MATCH

Indicates that although the mini-VDD did load successfully, when the ChipID that the mini-VDD calculated was compared against the value saved in the registry, they did not match. For example, suppose the user is using an S3-911 card and then decides to upgrade the display card to an S3-864. Because both cards use S3.VXD, the mini-VDD will load. But because the card model is different, the VDD will return a defect to configuration manager and set this flag.

REGISTRY_BPP_NOT_VALID

Indicates that the VDD was unable to obtain a bits-per-pixel value from the Registry.

REGISTRY_RESOLUTION_NOT_VALID

Indicates that the VDD was unable to obtain a resolution value from the Registry.

REGISTRY_DPI_NOT_VALID

Indicates that the VDD was unable to obtain a DPI value from the Registry.

MONITOR_DEVNODE_NOT_ACTIVE

Indicates that a call to the function GET_DISPLAY_CONFIG was made before the monitor DevNode handle had been created. This means that the monitor refresh rate information in the DISPLAYINFO structure is invalid.

MONITOR_INFO_NOT_VALID

Indicates that the values in diRefreshRateMax, diRefreshRateMin, diLowHorz, diHighHorz, diLowVert, diHighVert, diHorzSyncPolarity, and diVertSyncPolarity are not valid.

MONITOR_INFO_DISABLED_BY_USER

Indicates that either the "RefreshRate=" string in SYSTEM.INI had a negative number in it or that the string in the display software key "RefreshRate =" string was 0 or a negative number.

REFRESH_RATE_MAX_ONLY

Indicates that there was no data in the Registry for diLowHorz, diHighHorz, diLowVert, diHighVert, diHorzSyncPolarity, or diVertSyncPolarity and that the value returned in diRefreshRateMax is the only refresh rate data available and it was derived either from either the "RefreshRate=" string in SYSTEM.INI or the display software key "RefreshRate =" string in the Registry.

CARD_VDD_LOADED_OK

Indicates that a card VDD was successfully loaded and initialized.


diDevNodeHandle

Handle used to access information in the Registry about the display subsystem and passed to configuration management function calls.

diDriverName

Address of a null-terminated string containing the name of the driver.

diXRes

Width in pixels, of the display.

diYRes

Height in pixels, of the display.

diDPI

Number of dots per inch of the display.

diPlanes

Number of color planes.

diBpp

Number of adjacent color bits for each pixel.

diRefreshRateMax

Maximum refresh rate.

diRefreshRateMin

Minimum refresh rate.

diLowHorz and diHighHorz

Horizontal sync polarity ranges.

diLowVert and diHighVert

Vertical sync polarity ranges.

diMonitorDevNodeHandle

Handle used to access Registry information about the monitor.

diHorzSyncPolarity and diVertSyncPolarity

Sync polarity monitor settings.

See also ValidateMode, VDD_GET_DISPLAY_CONFIG