Функция SetupDiGetActualModelsSectionW (setupapi.h)

Статья
11/20/2024

Функция SetupDiGetActualModelsSection извлекает соответствующий декорированный раздел INF Models, используемый при установке устройства из 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 " и при необходимости задает украшения TargetOSVersion для имени раздела Модели. Сведения о INF-файлах и контексте INF-файла см. в разделах пакета SDK платформы по с использованием INF-файлов и структуры INFCONTEXT.

[in, optional] AlternatePlatformInfo

Указатель на структуру SP_ALTPLATFORM_INFO, которая предоставляет сведения об архитектуре версии Windows и процессора. Элемент cbSize этой структуры должен иметь значение sizeof(SP_ALTPLATFORM_INFO_V2). Этот параметр является необязательным и может иметь значение NULL.

[out, optional] InfSectionWithExt

Указатель на буфер, который получает строку, содержащую украшенные INF-Модели имя раздела и терминатор NULL. Если AlternatePlatformInfo не предоставлено, то к текущей платформе применяется украшенное имя раздела INF Models; в противном случае имя применяется к указанной альтернативной платформе. Этот параметр является необязательным и может иметь значение NULL. Если этот параметр NULL, функция возвращает TRUE и задает RequiredSize размеру символов, которые требуются для возврата украшенного модели и конца символа NULL.

[in] InfSectionWithExtSize

Размер в символах буфера DecoratedModelsSection . Если DecoratedModelsSectionnull, этот параметр должен иметь значение нулю.

[out, optional] RequiredSize

Указатель на переменную типа DWORD, которая получает размер в символах буфера DecoratedModelsSection, который требуется для получения имени раздела моделей и символа NULL. Этот параметр является необязательным и может иметь значение NULL.

Reserved

Зарезервировано для внутреннего использования системы. Этот параметр должен иметь значение NULL.

Возвращаемое значение

SetupDiGetActualModelsSection возвращает TRUE, если операция выполнена успешно. В противном случае функция возвращает FALSE и ошибку журнала можно получить с помощью вызова GetLastError.

Замечания

SetupDiGetActualModelsSection определяет, какие поля TargetOSVersion в записи идентификатор производителя (предоставленныеконтекстом ) применяются к текущей платформе, если Альтернативной ПлатформInfo не предоставляется или к альтернативной платформе, если предоставляются альтернативные сведения о платформе. SetupDiGetActualModelsSection выбирает наиболее подходящую платформу на основе всех полей TargetOSVersion, добавляет строку TargetOSVersion к имени раздела INF Models и возвращает к вызывающей стороне имя раздела модели. В записи идентификатора производителя основной версии операционной системы указывается поле OSMajorVersion, а дополнительная версия операционной системы указывается в поле OSMinorVersion.

Сведения о получении раздела INF DDInstall для устройства см. в разделе SetupDiGetActualSectionToInstall.

Заметка

Заголовок setupapi.h определяет SetupDiGetActualModelsSection в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows Server 2003 с пакетом обновления 1 (SP1) и более поздними версиями Windows.
целевая платформа	Настольный
заголовка	setupapi.h (include Setupapi.h)
библиотеки	Setupapi.lib

См. также

раздел INF DDInstall

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall

Поделиться через