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 Manufacturer 區段中的製造商識別碼專案。 製造商識別碼專案會指定 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 模型 區段名稱和 Null 結束字元的字串。 如果未提供 AlternatePlatformInfo ，裝飾的 INF 模型 區段名稱會套用至目前的平臺;否則，名稱會套用至指定的替代平臺。 這個參數是選擇性的，而且可以設定為 Null。 如果此參數為 Null，函式會傳回 TRUE 並將 RequiredSize 設定為大小，以字元為單位傳回裝飾 的 Models 區段名稱和終止的 Null 字元。
[in] InfSectionWithExtSize
DecoratedModelsSection緩衝區的大小，以字元為單位。 如果 DecoratedModelsSection 為 Null，此參數必須設定為零。
[out, optional] RequiredSize
接收 DecoratedModelsSection 緩衝區大小之 DWORD 類型變數的指標，其需要擷取裝飾 的 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 |