共用方式為


SP_DRVINFO_DATA_V2_W結構 (setupapi.h)

SP_DRVINFO_DATA 結構包含驅動程式的相關信息。 此結構是驅動程式資訊清單的成員,可以與特定裝置實例或全域與裝置資訊集相關聯。

語法

typedef struct _SP_DRVINFO_DATA_V2_W {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  WCHAR     Description[LINE_LEN];
  WCHAR     MfgName[LINE_LEN];
  WCHAR     ProviderName[LINE_LEN];
  FILETIME  DriverDate;
  DWORDLONG DriverVersion;
} SP_DRVINFO_DATA_V2_W, *PSP_DRVINFO_DATA_V2_W;

成員

cbSize

SP_DRVINFO_DATA 結構的大小,以位元組為單位。 如需詳細資訊,請參閱本主題中的一節。

DriverType

這個結構所表示的驅動程序類型。 必須是下列其中一個值:

SPDIT_CLASSDRIVER

這個結構代表類別驅動程式。

SPDIT_COMPATDRIVER

這個結構代表相容的驅動程式。

Reserved

保留。 僅供內部使用。

Description[LINE_LEN]

NULL 終止的字串,描述此驅動程式支援的裝置。

MfgName[LINE_LEN]

NULL 終止的字串,其中包含此驅動程式所支援之裝置製造商的名稱。

ProviderName[LINE_LEN]

NULL 終止的字串,提供此驅動程式的提供者。 這通常是建立驅動程式或 INF 檔案的組織名稱。 ProviderName 可以是空字串。

DriverDate

驅動程式的日期。 從 INF 檔案中的 DriverVer 專案。 如需 DriverVer 項目的詳細資訊,請參閱 INF DDInstall 一節

DriverVersion

驅動程式的版本。 從 INF 檔案中的 DriverVer 專案。

言論

SetupAPI.h中,此結構相當於 SP_DRVINFO_DATA_V1 或 SP_DRVINFO_DATA_V2,取決於您是否在原始程式碼中包含下列這一行:

#define  USE_SP_DRVINFO_DATA_V1 1

只有在您的元件必須在 Windows 98 或 Millennium Edition 或 Windows NT 上執行時,才定義此標識符。 如果您的元件只在 Windows 2000 和更新版本的 Windows 中執行,請勿定義標識符。 如果未定義標識碼,則會使用SP_DRVINFO_DATA_V2。

SP_DRVINFO_DATA_V1不包含 driverDate 和 DriverVersion 成員

SetupDiXxx 函式,以SP_DRVINFO_DATA結構做為參數,確認所提供結構的 cbSize 成員等於結構的大小,以位元組為單位。 如果輸入參數未正確設定 cbSize 成員,函式將會失敗並設定ERROR_INVALID_PARAMETER的錯誤碼。 如果輸出參數未正確設定 cbSize 成員,函式將會失敗,並設定ERROR_INVALID_USER_BUFFER的錯誤碼。

注意

setupapi.h 標頭會將 SP_DRVINFO_DATA_V2 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的 慣例。

要求

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

另請參閱

SetupDiEnumDriverInfo

SetupDiGetDriverInstallParams

SetupDiGetSelectedDriver

SetupDiSetDriverInstallParams

SetupDiSetSelectedDriver