SP_DRVINFO_DATA_V1_W結構 (setupapi.h)
SP_DRVINFO_DATA 結構包含驅動程式的相關信息。 此結構是驅動程式資訊清單的成員,可以與特定裝置實例或全域與裝置資訊集相關聯。
語法
typedef struct _SP_DRVINFO_DATA_V1_W {
DWORD cbSize;
DWORD DriverType;
ULONG_PTR Reserved;
WCHAR Description[LINE_LEN];
WCHAR MfgName[LINE_LEN];
WCHAR ProviderName[LINE_LEN];
} SP_DRVINFO_DATA_V1_W, *PSP_DRVINFO_DATA_V1_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 可以是空字串。
言論
在 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 和
SetupDiXxx 函式,以SP_DRVINFO_DATA結構做為參數,確認所提供結構的 cbSize 成員等於結構的大小,以位元組為單位。 如果輸入參數未正確設定 cbSize 成員,函式將會失敗並設定ERROR_INVALID_PARAMETER的錯誤碼。 如果輸出參數未正確設定 cbSize 成員,函式將會失敗,並設定ERROR_INVALID_USER_BUFFER的錯誤碼。
注意
setupapi.h 標頭會將 SP_DRVINFO_DATA_V1定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
標頭 | setupapi.h (包括 Setupapi.h) |