SetupDiGetActualModelsSectionA 函式 (setupapi.h)
SetupDiGetActualModelsSection函式會擷取從裝置 INF 檔案安裝裝置時要使用的適當裝飾INF 模型區段。
語法
WINSETUPAPI BOOL SetupDiGetActualModelsSectionA(
[in] PINFCONTEXT Context,
[in, optional] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[out, optional] PSTR InfSectionWithExt,
[in] DWORD InfSectionWithExtSize,
[out, optional] PDWORD RequiredSize,
PVOID Reserved
);
參數
[in] Context
INF 檔案內容的指標,指定INF 檔案之 INF 製造商區段中的製造商識別碼專案。 製造商識別碼專案會指定 INF Models區段名稱,並選擇性地指定Models區段名稱的TargetOSVersion裝飾。 如需 INF 檔案和 INF 檔案內容的相關資訊,請參閱 使用 INF 檔案 和 INFCONTEXT 結構的平臺 SDK 主題。
[in, optional] AlternatePlatformInfo
提供 Windows 版本和處理器架構相關資訊 之SP_ALTPLATFORM_INFO 結構的指標。 這個結構的 cbSize 成員必須設定為 sizeof (SP_ALTPLATFORM_INFO_V2 ) 。 此參數是選擇性的,而且可以設定為 Null。
[out, optional] InfSectionWithExt
緩衝區的指標,接收包含裝飾 INF Models 區段名稱和 Null 結束字元的字串。 如果未提供 AlternatePlatformInfo ,裝飾的 INF 模型 區段名稱會套用至目前的平臺;否則,名稱會套用至指定的替代平臺。 此參數是選擇性的,而且可以設定為 Null。 如果此參數為 Null,函式會傳回 TRUE ,並將 RequiredSize 設定為大小,以字元為單位,這是傳回裝飾 的 Models 區段名稱和終止 Null 字元的必要字元。
[in] InfSectionWithExtSize
DecoratedModelsSection緩衝區的大小,以字元為單位。 如果 DecoratedModelsSection 為 Null,這個參數必須設定為零。
[out, optional] RequiredSize
DWORD 型別變數的指標,可接收 DecoratedModelsSection 緩衝區的大小,以字元為單位,這是擷取裝飾 的 Models 區段名稱和終止 Null 字元的必要專案。 此參數是選擇性的,而且可以設定為 Null。
Reserved
保留供內部系統使用。 此參數必須設定為 Null。
傳回值
如果作業成功,SetupDiGetActualModelsSection會傳回TRUE。 否則,函式會傳回 FALSE ,而且可以透過呼叫 GetLastError來擷取記錄的錯誤。
備註
SetupDiGetActualModelsSection會決定CoNtext () 所提供製造商識別碼專案中的TargetOSVersion欄位套用至目前的平臺、如果未提供AlternatePlatformInfo或替代平臺資訊,則為替代平臺。 SetupDiGetActualModelsSection 會根據所有 TargetOSVersion 欄位選取最適當的平臺、將 TargetOSVersion 字串附加至 INF Models 區段名稱,並將裝飾的 INF Models 區段名稱傳回給呼叫端。 在 製造商識別碼 專案中,作業系統主要版本是由 [OSMajorVersion ] 欄位指定,而作業系統次要版本是由 [OSMinorVersion ] 欄位所指定。
如需擷取裝置 INF DDInstall 區段 的相關資訊,請參閱 SetupDiGetActualSectionToInstall。
注意
setupapi.h 標頭會根據 UNICODE 預處理器常數的定義,將 SetupDiGetActualModelsSection 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
最低支援的用戶端 | 在 Windows Server 2003 中提供 Service Pack 1 (SP1) 及更新版本的 Windows。 |
目標平台 | 桌上型 |
標頭 | setupapi.h (包括 Setupapi.h) |
程式庫 | Setupapi.lib |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應