Platform SDK: DirectX

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