共用方式為

SetupDiGetClassInstallParamsA 函式 （setupapi.h）

  • 發行項

SetupDiGetClassInstallParams 函式會擷取裝置資訊集或特定裝置資訊元素的類別安裝參數。

語法

WINSETUPAPI BOOL SetupDiGetClassInstallParamsA(
  [in]            HDEVINFO                DeviceInfoSet,
  [in, optional]  PSP_DEVINFO_DATA        DeviceInfoData,
  [out, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
  [in]            DWORD                   ClassInstallParamsSize,
  [out, optional] PDWORD                  RequiredSize
);

參數

[in] DeviceInfoSet

包含要擷取之類別安裝參數的 裝置資訊集句柄。

[in, optional] DeviceInfoData

DeviceInfoSet中指定裝置資訊專案的 SP_DEVINFO_DATA 結構的指標。 這個參數是選擇性的，而且可以 NULL。 如果指定此參數，SetupDiGetClassInstallParams 擷取指定裝置的類別安裝參數。 如果此參數 NULL，SetupDiGetClassInstallParams 擷取與 DeviceInfoSet 相關聯之全域類別驅動程式清單的類別安裝參數。

[out, optional] ClassInstallParams

包含 SP_CLASSINSTALL_HEADER 結構的緩衝區指標。 此結構 必須在輸入上將 cbSize 成員設為 sizeof（SP_CLASSINSTALL_HEADER），否則緩衝區視為無效。 在輸出中，InstallFunction 成員會填入所擷取類別安裝參數的 裝置安裝函式程式代碼。 如果緩衝區夠大，它也會接收函式程式代碼專屬的類別安裝參數結構。 如果未指定 ClassInstallParams，ClassInstallParamsSize 必須是 0。

[in] ClassInstallParamsSize

ClassInstallParams 緩衝區的大小，以位元組為單位。 如果提供緩衝區，它至少必須和 sizeof（SP_CLASSINSTALL_HEADER） 大小一樣大，。 如果未提供緩衝區，ClassInstallParamsSize 必須是 0。

[out, optional] RequiredSize

DWORD 類型的變數指標，可接收儲存類別安裝參數所需的位元元組數目。 這個參數是選擇性的，而且可以 NULL。

傳回值

如果函式成功，函式會傳回 TRUE。 否則，它會傳回 FALSE，而且可以使用呼叫 getLastError 擷取記錄的錯誤。

言論

類別安裝參數專屬於儲存在 ClassInstallHeader 欄位中，位於 ClassInstallParams 緩衝區開頭的特定 裝置安裝函式程式 代碼。

注意

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

要求

要求 價值
最低支援的用戶端 Microsoft Windows 2000 和更新版本的 Windows 中提供。
目標平臺 桌面
標頭 setupapi.h （包括 Setupapi.h）
連結庫 Setupapi.lib

另請參閱

SetupDiSetClassInstallParams