Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этом разделе приведены сведения о функциях установки устройства. С помощью функций установки устройства программное обеспечение установки может выполнять следующие типы операций:
Установка драйверов
Обработка кодов 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.Interfaces INF-файла устройства. |
|
Удаляет зарегистрированный интерфейс устройства из системы. |
|
Удаляет интерфейс устройства из набора сведений об устройстве. |
|
Задает указанный интерфейс устройства в качестве интерфейса по умолчанию для класса устройства. |
|
Устанавливает установщик классов или класс интерфейса. |
|
Открывает раздел реестра классов установки устройства , раздел реестра классов интерфейса устройства или определенный подраздел класса. Эта функция открывает указанный ключ на локальном компьютере или на удаленном компьютере. |
Функции свойств устройства (Windows Vista и более поздние версии)
Примечание.
SetupApi не поддерживается во всех выпусках Windows. По возможности следует использовать API нижнего слоя, такие как доступные через CfgMgr32.dll. Советы см. в статье "Перенос из SetupApi в CfgMgr32 ".
Извлекает свойство устройства, заданное для класса установки устройства или класса интерфейса устройства. |
|
Извлекает свойство класса для класса установки устройства или класса интерфейса устройства на локальном или удаленном компьютере. |
|
Извлекает массив ключей свойств устройства, представляющих свойства устройства, заданные для класса установки устройства или класса интерфейса устройства. |
|
Извлекает массив ключей свойств устройства, представляющих свойства устройства, заданные для класса установки устройства или класса интерфейса устройства на локальном или удаленном компьютере. |
|
Извлекает свойство устройства, заданное для интерфейса устройства. |
|
Извлекает массив ключей свойств устройства, представляющих свойства устройства, заданные для интерфейса устройства. |
|
Извлекает свойство экземпляра устройства. |
|
Извлекает массив ключей свойств устройства, представляющих свойства устройства, заданные для экземпляра устройства. |
|
Задает свойство класса для класса установки устройства или класса интерфейса устройства. |
|
Задает свойство устройства для класса установки устройства или класса интерфейса устройства на локальном или удаленном компьютере. |
|
Задает свойство интерфейса устройства. |
|
Задает свойство экземпляра устройства. |
Функции реестра
Примечание.
SetupApi не поддерживается во всех выпусках Windows. По возможности следует использовать API нижнего слоя, такие как доступные через CfgMgr32.dll. Советы см. в статье "Перенос из SetupApi в CfgMgr32 ".
Создает ключ реестра для сведений о конфигурации конкретного устройства и возвращает дескриптор ключа. |
|
Открывает раздел хранилища реестра для информации о конфигурации конкретного устройства и возвращает дескриптор ключа. |
|
Удаляет указанные доступные для пользователя разделы реестра, ассоциированные с элементом информации об устройстве. |
|
Открывает раздел реестра классов настроек или определенный подраздел класса. |
|
Открывает раздел реестра классов настройки устройства, раздел реестра классов интерфейса устройства или конкретный подраздел класса. Эта функция открывает указанный ключ на локальном компьютере или на удаленном компьютере. |
|
Создает энергонезависимый раздел реестра для хранения информации об экземпляре интерфейса устройства и возвращает дескриптор этого ключа. |
|
Открывает подраздел реестра, используемый приложениями и драйверами для хранения сведений, относящихся к экземпляру интерфейса устройства, и возвращает дескриптор ключа. |
|
Удаляет подраздел реестра, который использовался приложениями и драйверами для хранения сведений, относящихся к экземпляру интерфейса устройства. |
|
Задает указанное свойство устройства Plug and Play. |
|
Извлекает указанное свойство устройства Plug and Play. |
|
Извлекает указанное свойство класса устройства из реестра. |
|
Задает указанное свойство класса устройства в реестре. |
Другие функции
Извлекает соответствующий раздел "Модели INF", который необходимо использовать при установке устройства из INF-файла устройства. |
|
Извлекает соответствующий раздел DDInstall , используемый при установке устройства из INF-файла устройства. |
|
Извлекает имя раздела INF DDInstall , устанавливающего устройство для указанной архитектуры операционной системы и процессора. |
|
Извлекает понятное имя, связанное с идентификатором профиля оборудования. |
|
Извлекает удобочитаемое имя, связанное с идентификатором профиля оборудования на локальном или удаленном компьютере. |
|
Извлекает список всех идентификаторов профилей оборудования, которые на данный момент определены. |
|
Извлекает список всех определенных в настоящее время идентификаторов профилей оборудования на локальном или удаленном компьютере. |
|
Перезапускает указанное устройство или при необходимости запускает все устройства, которые работают с теми же драйверами функций и фильтров, что и указанное устройство. |