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 can't be backed up. Upgrade can be performed, but the components or drivers can't 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 may 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 may affect one or more programs on the system. The szMessage parameter contains the names of which programs may be affected. Upgrade not recommended.

DSETUP_CB_UPGRADE_KEEP

The system may 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 may be adversely affected.

DSETUP_CB_UPGRADE_UNKNOWN

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

Remarks

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

QuickInfo

  Windows NT: Requires version 4.0 SP3 or later.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dsetup.h.

See Also

DirectXSetupCallbackFunction