SP_DRVINFO_DATA_V1_A 結構 (setupapi.h)

發行項
08/26/2023

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

語法

typedef struct _SP_DRVINFO_DATA_V1_A {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  CHAR      Description[LINE_LEN];
  CHAR      MfgName[LINE_LEN];
  CHAR      ProviderName[LINE_LEN];
} SP_DRVINFO_DATA_V1_A, *PSP_DRVINFO_DATA_V1_A;

成員

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 或一個多國版或 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_V1定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。