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.
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