Использование функций установки устройств
В этом разделе перечислены функции установки устройств. С помощью функций установки устройства программное обеспечение установки может выполнять следующие типы операций:
Установка драйверов
Обработка кодов DIF.
Управление наборами сведений об устройствах.
Управление списками драйверов.
Управление интерфейсами устройств.
Управление значками и другими растровыми изображениями.
В следующих таблицах приведены сводки по следующим типам функций:
Функции сведений об устройстве
Функции со сведениями о драйвере
Обработчики установки устройств
Функции настройки установки устройства
Функции точечных изображений и значков
Функции свойств устройства (Windows Vista и более поздние версии)
Функции установки драйверов
Устанавливает указанный пакет драйвера, предварительно установленный в хранилище драйверов на устройстве PnP, которое присутствует в системе. (Windows Vista и более поздние версии Windows) |
|
Удаляет устройство и удаляет его узел устройства (devnode) из системы. (Windows 7 и более поздние версии Windows) |
|
Предварительно устанавливает пакет драйверов в хранилище драйверов, а затем устанавливает его на соответствующие устройства PnP, которые присутствуют в системе. (Windows Vista и более поздние версии Windows) |
|
Удаляет пакет драйверов из хранилища драйверов. (Windows 10 версии 1703 и более поздних версий Windows) |
|
Обновления пакет драйверов, установленный для соответствующих устройств PnP, присутствующих в системе. |
|
Выполняет откат пакета драйвера, установленного на указанном устройстве, до пакета драйвера резервного копирования, установленного для устройства. (Windows Vista и более поздние версии Windows) |
Функции сведений об устройстве
Примечание
SetupApi поддерживается не во всех выпусках Windows. По возможности следует использовать ИНТЕРФЕЙСы API нижнего уровня, например те, которые доступны через CfgMgr32.dll. Советы см. в разделе Перенос из SetupApi в CfgMgr32 .
Создает пустой набор сведений об устройстве. Этот набор можно связать с GUID класса. |
|
Создает пустой набор сведений об устройстве. Этот набор может быть связан с GUID класса и может использоваться для устройств на удаленном компьютере. |
|
Создает новый элемент сведений об устройстве и добавляет его в качестве нового элемента в указанный набор сведений об устройстве. |
|
Извлекает сведения о существующем экземпляре устройства и добавляет их в указанный набор сведений об устройстве. |
|
Возвращает структуру контекста для элемента сведений об устройстве набора сведений об устройстве. |
|
Извлекает идентификатор экземпляра устройства, связанный с элементом сведений об устройстве. |
|
Извлекает GUID класса, связанный с набором сведений об устройстве, если у него есть связанный класс. |
|
Извлекает сведения, связанные с набором сведений об устройстве, включая GUID класса, дескриптор удаленного компьютера и имя удаленного компьютера. |
|
Извлекает дескрипторы на листы свойств указанного элемента сведений об устройстве или класса настройки устройства указанного набора сведений об устройстве. |
|
Возвращает набор сведений об устройствах, содержащий все устройства указанного класса. |
|
Возвращает набор сведений об устройствах, содержащий все устройства указанного класса на локальном или удаленном компьютере. |
|
Задает указанный элемент сведений об устройстве в качестве выбранного в данный момент элемента набора сведений об устройстве. Эта функция обычно используется мастером установки. |
|
Извлекает выбранное в данный момент устройство для указанного набора сведений об устройстве. |
|
Регистрирует созданный экземпляр устройства в диспетчере Plug and Play. |
|
Удаляет элемент из указанного набора сведений об устройстве. Эта функция не удаляет фактическое устройство. |
|
Уничтожает набор сведений об устройстве и освобождает всю связанную память. |
Функции со сведениями о драйвере
Создает список драйверов, связанных с указанным экземпляром устройства или со списком драйверов глобального класса набора сведений об устройствах. |
|
Перечисляет элементы списка сведений о драйвере. |
|
Извлекает подробные сведения для указанного элемента сведений о драйвере. |
|
Задает указанный член списка драйверов в качестве текущего выбранного драйвера. Его также можно использовать для сброса списка драйверов, чтобы не было выбранного в данный момент драйвера. |
|
Извлекает элемент списка драйверов, который был выбран в качестве устанавливаемого драйвера. |
|
Отменяет поиск по списку драйверов, который в настоящее время выполняется в другом потоке. |
|
Удаляет список сведений о драйверах. |
Обработчики установки устройств
Вызывает соответствующий установщик класса и все зарегистрированные совместные установщики с указанным запросом на установку. |
|
Обработчик по умолчанию для запроса DIF_PROPERTYCHANGE. Его можно использовать для изменения состояния установленного устройства. |
|
Регистрирует установщики для конкретного устройства, перечисленные в INF-файле для указанного устройства. Эта функция является обработчиком по умолчанию для DIF_REGISTER_COINSTALLERS. |
|
Обработчик по умолчанию для запроса DIF_INSTALLDEVICE. |
|
Обработчик по умолчанию для запроса DIF_INSTALLDEVICEFILES. |
|
Обработчик по умолчанию для запроса DIF_INSTALLINTERFACES. Он устанавливает интерфейсы, перечисленные в DDInstall. Раздел Interfaces в INF-файле устройства. |
|
Эта функция устарела и не может использоваться ни в одной версии Microsoft Windows. |
|
Обработчик по умолчанию для запроса DIF_REMOVEDEVICE. |
|
Обработчик по умолчанию для запроса DIF_UNREMOVE. |
|
Обработчик по умолчанию для запроса DIF_REGISTERDEVICE. |
|
Обработчик по умолчанию для запроса DIF_SELECTDEVICE. |
|
Обработчик по умолчанию для запроса DIF_SELECTBESTCOMPATDRV. |
|
Обработчик по умолчанию для запроса DIF_SELECTDEVICE. |
Функции настройки установки устройства
Извлекает параметры установки класса для набора сведений об устройстве или определенного элемента сведений об устройстве. |
|
Задает или очищает параметры установки класса для набора сведений об устройстве или определенного элемента сведений об устройстве. |
|
Извлекает параметры установки устройства для набора сведений об устройстве или определенного элемента сведений об устройстве. |
|
Задает параметры установки устройства для набора сведений об устройстве или определенного элемента сведений об устройстве. |
|
Извлекает параметры установки для указанного драйвера. |
|
Задает параметры установки для указанного драйвера. |
Настройка функций класса
Возвращает список идентификаторов GUID класса установки, который включает все классы, установленные в системе. |
|
Возвращает список GUID класса установки, который включает все классы, установленные в локальной или удаленной системе. |
|
Извлекает описание класса, связанное с указанным GUID класса установки. |
|
Возвращает описание класса установки, установленного на локальном или удаленном компьютере. |
|
Извлекает класс указанного INF-файла устройства. |
|
Извлекает идентификаторы GUID, связанные с указанным именем класса. Этот список основан на том, какие классы в настоящее время установлены в системе. |
|
Извлекает идентификаторы GUID, связанные с указанным именем класса. Этот итоговый список содержит классы, установленные в настоящее время на локальном или удаленном компьютере. |
|
Получает имя класса, связанное с идентификатором GUID класса. |
|
Извлекает имя класса, связанное с идентификатором GUID класса. Класс можно установить на локальном или удаленном компьютере. |
|
Устанавливает раздел ClassInstall32 указанного INF-файла. |
|
Устанавливает установщик класса или класс интерфейса. |
|
Открывает раздел реестра класса настройки устройства или определенный подраздел класса . |
|
Открывает раздел реестра класса настройки устройства, раздел реестра класса интерфейса устройства или определенный подраздел класса . Эта функция открывает указанный ключ на локальном или удаленном компьютере. |
Функции точечных изображений и значков
Создает список изображений, содержащий растровые изображения для каждого установленного класса, и возвращает список в структуре данных. |
|
Создает список растровых изображений для каждого класса, установленного на локальном или удаленном компьютере. |
|
Извлекает индекс в списке изображений класса указанного класса. |
|
Извлекает индекс мини-значка, предоставленного для указанного класса. |
|
Рисует указанный мини-значок в запрошенном расположении. |
|
Загружает большой и мини-значок для указанного класса. |
|
Загружает значок устройства для указанного устройства. (Windows Vista и более поздние версии Windows) |
|
Уничтожает список образов классов. |
Функции интерфейса устройства
Примечание
SetupApi поддерживается не во всех выпусках Windows. По возможности следует использовать ИНТЕРФЕЙСы API нижнего уровня, например те, которые доступны через CfgMgr32.dll. Советы см. в разделе Перенос из SetupApi в CfgMgr32 .
Регистрирует функциональные возможности устройства (интерфейс устройства). |
|
Извлекает сведения о существующем интерфейсе устройства и добавляет их в указанный набор сведений об устройстве. |
|
Возвращает псевдоним указанного интерфейса устройства. |
|
Возвращает набор сведений об устройстве, содержащий все устройства указанного класса. |
|
Возвращает набор сведений об устройстве, содержащий все устройства указанного класса на локальном или удаленном компьютере. |
|
Возвращает структуру контекста для элемента интерфейса устройства набора сведений об устройстве. Каждый вызов возвращает сведения об одном интерфейсе устройства. Функцию можно вызывать несколько раз для получения сведений о нескольких интерфейсах, предоставляемых одним или несколькими устройствами. |
|
Возвращает сведения об определенном интерфейсе устройства. |
|
Создает подраздел реестра для хранения сведений об экземпляре интерфейса устройства и возвращает дескриптор ключа. |
|
Открывает подраздел реестра, который используется приложениями и драйверами для хранения сведений, относящихся к экземпляру интерфейса устройства, и возвращает дескриптор в ключ. |
|
Удаляет подраздел реестра, который использовался приложениями и драйверами для хранения сведений, относящихся к экземпляру интерфейса устройства. |
|
Обработчик по умолчанию для запроса DIF_INSTALLINTERFACES. Он устанавливает интерфейсы, перечисленные в DDInstall. Раздел интерфейсов INF-файла устройства. |
|
Удаляет зарегистрированный интерфейс устройства из системы. |
|
Удаляет интерфейс устройства из набора сведений об устройствах. |
|
Задает указанный интерфейс устройства в качестве интерфейса по умолчанию для класса устройства. |
|
Устанавливает установщик класса или класс интерфейса. |
|
Открывает раздел реестра класса настройки устройства , раздел реестра класса интерфейса устройства или определенный подраздел класса . Эта функция открывает указанный ключ на локальном компьютере или на удаленном компьютере. |
Функции свойств устройства (Windows Vista и более поздние версии)
Примечание
SetupApi поддерживается не во всех выпусках Windows. По возможности следует использовать API нижнего уровня, например api, доступные черезCfgMgr32.dll. Советы см. в статье Перенос из SetupApi в CfgMgr32 .
Извлекает свойство устройства, заданное для класса настройки устройства или класса интерфейса устройства. |
|
Извлекает свойство класса для класса настройки устройства или класса интерфейса устройства на локальном или удаленном компьютере. |
|
Извлекает массив ключей свойств устройства, представляющих свойства устройства, заданные для класса настройки устройства или класса интерфейса устройства. |
|
Извлекает массив ключей свойств устройства, представляющих свойства устройства, заданные для класса настройки устройства или класса интерфейса устройства на локальном или удаленном компьютере. |
|
Извлекает свойство устройства, заданное для интерфейса устройства. |
|
Извлекает массив ключей свойств устройства, представляющих свойства устройства, заданные для интерфейса устройства. |
|
Извлекает свойство экземпляра устройства. |
|
Извлекает массив ключей свойств устройства, представляющих свойства устройства, заданные для экземпляра устройства. |
|
Задает свойство класса для класса настройки устройства или класса интерфейса устройства. |
|
Задает свойство устройства для класса настройки устройства или класса интерфейса устройства на локальном или удаленном компьютере. |
|
Задает свойство устройства интерфейса устройства. |
|
Задает свойство экземпляра устройства. |
Функции реестра
Примечание
SetupApi поддерживается не во всех выпусках Windows. По возможности следует использовать API нижнего уровня, например api, доступные черезCfgMgr32.dll. Советы см. в статье Перенос из SetupApi в CfgMgr32 .
Создает раздел хранилища реестра для сведений о конфигурации устройства и возвращает дескриптор для ключа. |
|
Открывает раздел хранилища реестра для сведений о конфигурации устройства и возвращает дескриптор ключа. |
|
Удаляет указанные доступные пользователю разделы реестра, связанные с элементом сведений об устройстве. |
|
Открывает раздел реестра класса установки или определенный подраздел класса . |
|
Открывает раздел реестра класса настройки устройства, раздел реестра класса интерфейса устройства или определенный подраздел класса . Эта функция открывает указанный ключ на локальном компьютере или на удаленном компьютере. |
|
Создает неизменяемый подраздел реестра для хранения сведений об экземпляре интерфейса устройства и возвращает дескриптор в ключ. |
|
Открывает подраздел реестра, который используется приложениями и драйверами для хранения сведений, относящихся к экземпляру интерфейса устройства, и возвращает дескриптор в ключ. |
|
Удаляет подраздел реестра, который использовался приложениями и драйверами для хранения сведений, относящихся к экземпляру интерфейса устройства. |
|
Задает указанное свойство устройства Plug and Play. |
|
Извлекает указанное свойство устройства Plug and Play. |
|
Извлекает указанное свойство класса устройства из реестра. |
|
Задает указанное свойство класса устройства в реестре. |
Другие функции
Извлекает соответствующий раздел "Модели INF ", используемый при установке устройства из INF-файла устройства. |
|
Извлекает соответствующий раздел DDInstall , используемый при установке устройства из INF-файла устройства. |
|
Извлекает имя раздела INF DDInstall , который устанавливает устройство для указанной архитектуры операционной системы и процессора. |
|
Извлекает понятное имя, связанное с идентификатором профиля оборудования. |
|
Извлекает понятное имя, связанное с идентификатором профиля оборудования на локальном или удаленном компьютере. |
|
Извлекает список всех определенных в настоящее время идентификаторов профилей оборудования. |
|
Извлекает список всех определенных в настоящее время идентификаторов профилей оборудования на локальном или удаленном компьютере. |
|
Перезапускает указанное устройство или, при необходимости, запускает все устройства, управляемые теми же драйверами функций и фильтров, что и указанное устройство. |