SP_DRVINSTALL_PARAMS 結構 (setupapi.h)

發行項
03/15/2023

SP_DRVINSTALL_PARAMS 結構包含與特定驅動程式資訊專案相關聯的驅動程式安裝參數。

語法

typedef struct _SP_DRVINSTALL_PARAMS {
  DWORD     cbSize;
  DWORD     Rank;
  DWORD     Flags;
  DWORD_PTR PrivateData;
  DWORD     Reserved;
} SP_DRVINSTALL_PARAMS, *PSP_DRVINSTALL_PARAMS;

成員

cbSize

SP_DRVINSTALL_PARAMS 結構的大小，以位元組為單位。

Rank

此驅動程式的排名比對。範圍從 0 到 n，其中 0 是最相容的。

Flags

控制此驅動程式上運作之函式的旗標。可以是下列各項的組合：

DNF_ALWAYSEXCLUDEFROMLIST (Windows Vista 和更新版本的 Windows)

如果設定，則不論執行列舉的客戶端為何，此旗標都會防止列舉驅動程序節點。

DNF_AUTHENTICODE_SIGNED (Windows Server 2003 和更新版本的 Windows)

此驅動程式的 INF 檔案是由 Authenticode 簽章簽署。此旗標是安裝程式的唯讀旗標。

如需詳細資訊，請參閱使用 SetupAPI 驗證驅動程式 Authenticode 簽章。

DNF_BAD_DRIVER

請勿使用此驅動程式。安裝程式可以讀取和寫入此旗標。

如果設定此旗標， SetupDiSelectBestCompatDrv 和 SetupDiSelectDevice 會忽略此驅動程式。

類別安裝程式或共同安裝程式可以設定此旗標，以防止 Windows 在 [選取驅動程式] 對話框中列出驅動程式。例如，安裝程式可能會在處理 DIF_SELECTDEVICE 或 DIF_SELECTBESTCOMPATDRV 要求時設定此旗標。

DNF_BASIC_DRIVER (Windows XP 和更新版本的 Windows)

此驅動程式是基本驅動程式。此旗標是安裝程式的唯讀旗標。

DNF_CLASS_DRIVER

此驅動程式是類別驅動程式。此旗標是安裝程式的唯讀旗標。

DNF_COMPATIBLE_DRIVER

此驅動程式是相容的驅動程式。此旗標是安裝程式的唯讀旗標。

DNF_DUPDESC

還有其他提供者提供與此驅動程式相同的描述。此旗標是安裝程式的唯讀旗標。

DNF_DUPDRIVERVER (Windows XP 和更新版本的 Windows)

還有其他提供驅動程式的提供者，其版本與此驅動程式相同。此旗標是安裝程式的唯讀旗標。

DNF_DUPPROVIDER

還有其他提供者提供與此驅動程式相同的描述。此驅動程式與其相符專案的唯一差異是驅動程式日期。此旗標是安裝程式的唯讀旗標。

如果設定此旗標，Windows 會顯示驅動程式旁的驅動程式日期和驅動程式版本，讓用戶能夠將其與相符項目區別。

DNF_EXCLUDEFROMLIST

請勿在任何驅動程式選取對話框中顯示此驅動程式。

DNF_INBOX_DRIVER (Windows Vista 和更新版本的 Windows)

此驅動程式節點衍生自此版本 Windows 隨附的 INF 檔案。

DNF_INET_DRIVER

此驅動程式來自因特網或 Windows Update。此旗標是安裝程式的唯讀旗標。

如果您呼叫 SetupCopyOEMInf ，您必須指定SPOST_URL旗標，讓 Windows 將此 INF 複製到 %SystemRoot%\inf 目錄中時，Windows 會將它標示為因特網 INF。如果您省略此步驟，Windows 將會嘗試使用此裝置來安裝其他裝置。產生的問題在於 Windows 不再有原始程式檔，最後會提示使用者輸入無效的路徑。

DNF_INF_IS_SIGNED (Windows XP 和更新版本的 Windows)

此旗標是安裝程式的唯讀旗標，如果下列任一條件成立，則會設定：

驅動程式具有 WHQL 發行簽章。
驅動程式是收件匣驅動程式。
驅動程式具有 Authenticode 簽章。

如需詳細資訊，請參閱驅動程序簽署。

DNF_INSTALLEDDRIVER (Windows Vista 和更新版本的 Windows)

此驅動程式節點目前已針對裝置安裝。此旗標是安裝程式的唯讀旗標。

DNF_LEGACYINF

此驅動程式來自舊版 INF 檔案。此旗標僅適用於 NT 型作業系統。此旗標是安裝程式的唯讀旗標。

DNF_NODRIVER

如果未為此邏輯驅動程式安裝任何實體驅動程式，請設定。

DNF_OEM_F6_INF (Windows XP 和更新版本的 Windows)

保留的。

DNF_OLD_INET_DRIVER

此驅動程式來自因特網，但 Windows 目前無法存取其原始程序檔。此旗標是安裝程式的唯讀旗標。

系統不會安裝標示為此旗標的驅動程式，因為 Windows 沒有原始程式檔，最後會提示使用者輸入無效的路徑。這類驅動程式的 INF 可用於安裝裝置以外的所有專案。

DNF_OLDDRIVER

此驅動程式目前/先前已控制相關聯的裝置。此旗標是安裝程式的唯讀旗標。

DNF_REQUESTADDITIONALSOFTWARE (Windows 7 和更新版本的 Windows)

如果驅動程式套件只是操作裝置所需的軟體解決方案的一部分，請設定此旗標。在此情況下，驅動程式套件需要安裝其他軟體。

如需詳細資訊，請參閱接下來的＜備註＞一節。

PrivateData

類別安裝程式可用來儲存私人數據的欄位。共同安裝程式不應該使用此欄位。

Reserved

保留的。僅供內部使用。

備註

從 Windows 7 開始，安裝程式或共同安裝程式可以設定 DNF_REQUESTADDITIONALSOFTWARE 旗標，以指出驅動程式套件需要可能或未安裝在電腦中的其他軟體。

安裝裝置的驅動程式套件之後，如果安裝程式設定DNF_REQUESTADDITIONALSOFTWARE旗標，隨插即用 (PnP) 管理員會執行下列步驟：

PnP 管理員會產生具有 RequestAddtionalSoftware 類型的問題報告和解決方案 (PRS) 錯誤報告。此報告包含裝置的特定硬體識別碼和計算機系統架構的相關信息。
如果有獨立硬體廠商提供的解決方案， (IHV) 裝置特定軟體，解決方案就會下載到計算機。
注意解決方案的下載不會安裝軟體本身。
如果電腦上未安裝裝置特定軟體，PnP 管理員會將解決方案提供給使用者，並提供下載軟體的連結。接著，使用者可以依照解決方案中提供的指示，選擇下載並安裝此軟體。

注意如果驅動程式套件的 INF 檔案已在 INF ControlFlags 區段中設定 RequestAdditionalSoftware 旗標，安裝程式就不需要設定DNF_REQUESTADDITIONALSOFTWARE旗標。

規格需求

需求	值
標頭	setupapi.h (包括 Setupapi.h)

另請參閱

SetupDiGetDriverInstallParams

SetupDiSetDriverInstallParams

共用方式為