DirectX 5 Redocumentation
A redocumentation of DirectX 5, brought to you by a bunch of Infomaniacs.
DirectX Setup Callback Upgrade Types

Macros

#define DSETUP_CB_UPGRADE_TYPE_MASK   0x000F
 
#define DSETUP_CB_UPGRADE_UNNECESSARY   0x000F
 The existing device driver is newer than the driver being installed. An upgrade is not recommended. More...
 
#define DSETUP_CB_UPGRADE_KEEP   0x0001
 The system may fail if this device driver is upgraded. Upgrade not allowed. More...
 
#define DSETUP_CB_UPGRADE_SAFE   0x0002
 DirectXSetup 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. More...
 
#define DSETUP_CB_UPGRADE_FORCE   0x0004
 Windows may not function correctly if the component is not upgraded. The upgrade will be performed. More...
 
#define DSETUP_CB_UPGRADE_UNKNOWN   0x0008
 DirectXSetup 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. More...
 
#define DSETUP_CB_UPGRADE_HASWARNINGS   0x0100
 DirectXSetup can upgrade the driver for this device, but doing so may affect one or more programs on the system. szMessage contains the names of which programs may be affected. Upgrade not recommended. More...
 
#define DSETUP_CB_UPGRADE_CANTBACKUP   0x0200
 The old system components can’t be backed up. Upgrade can be performed, but the components or drivers can’t be restored later. More...
 
#define DSETUP_CB_UPGRADE_DEVICE_ACTIVE   0x0800
 The device is currently in use. More...
 
#define DSETUP_CB_UPGRADE_DEVICE_DISPLAY   0x1000
 The device driver being upgraded is for a display device. More...
 
#define DSETUP_CB_UPGRADE_DEVICE_MEDIA   0x2000
 

Detailed Description

Contains information about the upgrade type for Windows.

Macro Definition Documentation

◆ DSETUP_CB_UPGRADE_CANTBACKUP

#define DSETUP_CB_UPGRADE_CANTBACKUP   0x0200

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

#define DSETUP_CB_UPGRADE_DEVICE_ACTIVE   0x0800

The device is currently in use.

◆ DSETUP_CB_UPGRADE_DEVICE_DISPLAY

#define DSETUP_CB_UPGRADE_DEVICE_DISPLAY   0x1000

The device driver being upgraded is for a display device.

◆ DSETUP_CB_UPGRADE_DEVICE_MEDIA

#define DSETUP_CB_UPGRADE_DEVICE_MEDIA   0x2000

The device driver being upgraded is for a media device.

◆ DSETUP_CB_UPGRADE_FORCE

#define DSETUP_CB_UPGRADE_FORCE   0x0004

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

◆ DSETUP_CB_UPGRADE_HASWARNINGS

#define DSETUP_CB_UPGRADE_HASWARNINGS   0x0100

DirectXSetup can upgrade the driver for this device, but doing so may affect one or more programs on the system. szMessage contains the names of which programs may be affected. Upgrade not recommended.

◆ DSETUP_CB_UPGRADE_KEEP

#define DSETUP_CB_UPGRADE_KEEP   0x0001

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

◆ DSETUP_CB_UPGRADE_SAFE

#define DSETUP_CB_UPGRADE_SAFE   0x0002

DirectXSetup 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_TYPE_MASK

#define DSETUP_CB_UPGRADE_TYPE_MASK   0x000F
Remarks
this is undocumented, so lets assuming it is the same as DSETUP_CB_UPGRADE_UNNECESSARY. The existing device driver is newer than the driver being installed. An upgrade is not recommended.

◆ DSETUP_CB_UPGRADE_UNKNOWN

#define DSETUP_CB_UPGRADE_UNKNOWN   0x0008

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

◆ DSETUP_CB_UPGRADE_UNNECESSARY

#define DSETUP_CB_UPGRADE_UNNECESSARY   0x000F

The existing device driver is newer than the driver being installed. An upgrade is not recommended.

Remarks
This is documented, but DSETUP_CB_UPGRADE_TYPE_MASK is not. We're assuming it is the same.