Platform SDK: DirectX

DSETUP_CB_UPGRADEINFO

DSETUP_CB_UPGRADEINFO 構造体は、パラメータとしてアプリケーションで定義した DirectXSetupCallbackFunction へ渡される。この構造体には、Reason パラメータが DSETUP_CB_MSG_CHECK_DRIVER_UPGRADE のときだけ、有効な情報が格納される。コールバック関数は、この構造体を使用して、実行するアップグレードに関するステータス情報を取得することができる。

typedef struct _DSETUP_CB_UPGRADEINFO {
    DWORD UpgradeFlags;
} DSETUP_CB_UPGRADEINFO;

メンバ

UpgradeFlags
アップグレード ステータスは 1 つ以上のフラグで示される。次の各値が定義されている。
DSETUP_CB_UPGRADE_CANTBACKUP
古いシステム コンポーネントをバック アップできない。アップグレードは実行可能だが、アップグレード後のコンポーネントやドライバの復元はできない。
DSETUP_CB_UPGRADE_DEVICE_ACTIVE
デバイスは現在使用中である。
DSETUP_CB_UPGRADE_DEVICE_DISPLAY
アップグレード対象のデバイス ドライバは、ディスプレイ デバイス用のドライバである。
DSETUP_CB_UPGRADE_DEVICE_MEDIA
アップグレード対象のデバイス ドライバは、メディア デバイス用のドライバである。
DSETUP_CB_UPGRADE_FORCE
コンポーネントがアップグレードされなければ、Windows が正常に機能しない恐れがある。アップグレードは実行される。
DSETUP_CB_UPGRADE_HASWARNINGS
DirectSetup でこのデバイスのドライバをアップグレードすることはできるが、システム上の 1 つ以上のプログラムに影響を与える恐れがある。影響を受けると見られるプログラムの名前は szMessage に格納される。アップグレードは推奨されない。
DSETUP_CB_UPGRADE_KEEP
このデバイス ドライバをアップグレードすると、システムに障害が発生する恐れがある。アップグレードは許可されない。
DSETUP_CB_UPGRADE_SAFE
DirectSetup はこのデバイス ドライバを安全にアップグレードできる。アップグレードが推奨される。安全なアップグレードとは、Windows の動作に悪影響を与えないことを示す。ハードウェアに依存する一部のプログラムについては、悪影響が及ぶ可能性がある。
DSETUP_CB_UPGRADE_UNKNOWN
このデバイスの既存のドライバが認識できない。この値の状況は頻繁に発生する。アップグレードすることにより、このデバイスの使用に悪影響を与える可能性がある。アップグレードを実行しないよう強く推奨する。

注意

UpgradeFlags からアップグレード タイプ (FORCE、KEEP、SAFE、または UNKNOWN) を取得するには、値 DSETUP_CB_UPGRADE_TYPE_MASK を使用する。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dsetup.h で宣言。

参照

DirectXSetupCallbackFunction