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

另請參閱

INF DDInstall 區段

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall