通过

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

指向 SP_ALTPLATFORM_INFO 结构的指针，该结构提供有关 Windows 版本和处理器体系结构的信息。 此结构的 cbSize 成员必须设置为 sizeof（SP_ALTPLATFORM_INFO_V2）。 此参数是可选的，可以设置为 NULL。

[out, optional] InfSectionWithExt

指向接收包含修饰的 INF Models 节名称和 NULL 终止符的字符串的缓冲区的指针。 如果未提供 alternatePlatformInfo ，则修饰的 INF 模型 节名称适用于当前平台;否则，该名称适用于指定的备用平台。 此参数是可选的，可以设置为 NULL。 如果此参数 NULL，则该函数将返回 TRUE，并将 RequiredSize 设置为返回修饰的 Models 节名称和终止 NULL 字符所需的大小。

[in] InfSectionWithExtSize

DecoratedModelsSection 缓冲区的大小（以字符为单位）。 如果 DecoratedModelsSectionNULL，则必须将此参数设置为零。

[out, optional] RequiredSize

指向接收 DecoratedModelsSection 缓冲区大小（以字符为单位）的 DWORD 类型的变量的指针，该缓冲区需要检索修饰的 模型 节名称和终止 NULL 字符。 此参数是可选的，可以设置为 NULL。

Reserved

保留供内部系统使用。 此参数必须设置为 NULL。

返回值

SetupDiGetActualModelsSection 如果操作成功，TRUE 返回。 否则，函数返回 FALSE，可以通过调用 getLastError来检索记录的错误。

言论

SetupDiGetActualModelsSection 确定 制造商标识符 项（上下文提供）中的哪些 TargetOSVersion 字段适用于当前平台（如果未提供 AlternatePlatformInfo，或者提供给备用平台（如果提供了备用平台信息）。 SetupDiGetActualModelsSection 根据所有 TargetOSVersion 字段选择最合适的平台，将 TargetOSVersion 字符串追加到 INF Models 节名称，并将修饰的 INF Models 节名称返回给调用方。 在 制造商标识符 条目中，操作系统主版本由 OSMajorVersion 字段指定，操作系统次要版本由 OSMinorVersion 字段指定。

有关检索设备的 INF DDInstall 节 的信息，请参阅 SetupDiGetActualSectionToInstall。

注意

setupapi.h 标头将 SetupDiGetActualModelsSection 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 在 Windows Server 2003 中提供 Service Pack 1（SP1）和更高版本的 Windows。
目标平台 桌面
标头 setupapi.h （包括 Setupapi.h）
库 Setupapi.lib

另请参阅

INF DDInstall 节

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall