共用方式為

SetupDiGetActualModelsSectionA 函式 （setupapi.h）

  • 發行項

SetupDiGetActualModelsSection 函式會擷取適當的裝飾 INF Models 區段， 從裝置 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 區段名稱，並選擇性地指定 TargetOSVersion 裝飾 Models 區段名稱。 如需 INF 檔案和 INF 檔案內容的相關信息，請參閱使用 INF 檔案 和 INFCONTEXT 結構的平臺 SDK 主題。

[in, optional] AlternatePlatformInfo

SP_ALTPLATFORM_INFO 結構的指標，提供 Windows 版本和處理器架構的相關信息。 這個結構的 cbSize 成員必須設定為 sizeof（SP_ALTPLATFORM_INFO_V2）。 這個參數是選擇性的，而且可以設定為 NULL。

[out, optional] InfSectionWithExt

緩衝區的指標，接收字串，其中包含裝飾的 INF Models 區段名稱和 NULL 終止符。 如果未提供 AlternatePlatformInfo，則裝飾的 INF Models 區段名稱會套用至目前的平臺;否則，名稱會套用至指定的替代平臺。 這個參數是選擇性的，而且可以設定為 NULL。 如果此參數 NULL，函式會傳回 TRUE TRUE，並將 requiredSize 設定為大小，以字元為單位，傳回裝飾 Models 區段名稱和終止 NULL 字元。

[in] InfSectionWithExtSize

DecoratedModelsSection 緩衝區的大小，以字元為單位。 如果 DecoratedModelsSectionNULL，此參數必須設定為零。

[out, optional] RequiredSize

接收 DecoratedModelsSection 緩衝區大小之 DWORD 類型變數的指標，此緩衝區需要擷取裝飾的 Models 區段名稱和終止的 NULL 字元。 這個參數是選擇性的，而且可以設定為 NULL。

Reserved

保留供內部系統使用。 這個參數必須設定為 NULL。

傳回值

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

言論

SetupDiGetActualModelsSection 會決定 製造商標識符 專案中哪些 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

另請參閱

INF DDInstall 區段

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall