SetupDiGetActualModelsSectionW 函式 (setupapi.h)
SetupDiGetActualModelsSection 函式會擷取從裝置 INF 檔案安裝裝置時要使用的適當裝飾 INF 模型區段。
語法
WINSETUPAPI BOOL SetupDiGetActualModelsSectionW(
[in] PINFCONTEXT Context,
[in, optional] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[out, optional] PWSTR 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 |