DSETUP_CB_UPGRADEINFO

The DSETUP_CB_UPGRADEINFO structure is passed as a parameter to the application-defined DirectXSetupCallbackFunction. It contains valid information only when the Reason parameter is DSETUP_CB_MSG_CHECK_DRIVER_UPGRADE. Callback functions can use it to get status information on the upgrade that is about to be done.

typedef struct _DSETUP_CB_UPGRADEINFO {
    DWORD UpgradeFlags;
} DSETUP_CB_UPGRADEINFO;

Members

UpgradeFlags

One or more flags indicating the status of the upgrade. The following values are defined:

DSETUP_CB_UPGRADE_CANTBACKUP

The old system components cannot be backed up. Upgrade can be performed, but the components or drivers cannot be restored later.

DSETUP_CB_UPGRADE_DEVICE_ACTIVE

The device is currently in use.

DSETUP_CB_UPGRADE_DEVICE_DISPLAY

The device driver being upgraded is for a display device.

DSETUP_CB_UPGRADE_DEVICE_MEDIA

The device driver being upgraded is for a media device.

DSETUP_CB_UPGRADE_FORCE

Windows might not function correctly if the component is not upgraded. The upgrade will be performed.

DSETUP_CB_UPGRADE_HASWARNINGS

DirectSetup can upgrade the driver for this device, but doing so might affect one or more programs on the system. The szMessage parameter contains the names of the programs that might be affected. Upgrade not recommended.

DSETUP_CB_UPGRADE_KEEP

The system might fail if this device driver is upgraded. Upgrade not allowed.

DSETUP_CB_UPGRADE_SAFE

DirectSetup can safely upgrade this device driver. Upgrade recommended. A safe upgrade will not adversely affect the operation of Windows. Some hardware-dependent programs might be adversely affected.

DSETUP_CB_UPGRADE_UNKNOWN

DirectSetup does not recognize the existing driver for this device. This value occurs frequently. Upgrading might adversely affect the use of the device. It is strongly recommended that the upgrade not be performed.

Remarks

Use the DSETUP_CB_UPGRADE_TYPE_MASK value to extract the upgrade type (FORCE, KEEP, SAFE, or UNKNOWN) from UpgradeFlags.

Requirements

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

See Also

DirectXSetupCallbackFunction