Объект устройства платформы

Предупреждение

UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2.

Архивные примеры UMDF 1 можно найти в Windows 11 версии 22H2 — обновление примеров драйверов за май 2022 г.

Дополнительные сведения см. в разделе начало работы с помощью UMDF.

Объект устройства платформы предоставляется драйверам с помощью интерфейса IWDFDevice . Объект framework device — это представление платформы устройства в системе. Каждый объект устройства имеет родительский объект драйвера.

Когда новое устройство поступает в систему, платформа вызывает метод IDriverEntry::OnDeviceAdd , чтобы уведомить водителя о прибытии и передает интерфейсы IWDFDriver и IWDFDeviceInitialize в вызове. Драйвер может вызывать методы интерфейса IWDFDeviceInitialize для инициализации нового устройства. Например, драйвер вызывает метод IWDFDeviceInitialize::RetrieveDevicePropertyStore для запроса сведений об устройстве, которые предоставляются при установке устройства. Затем драйвер может вызвать метод IWDFDriver::CreateDevice для настройки и создания объекта устройства.

Когда драйверы создают объект устройства платформы, они могут зарегистрировать интерфейсы IPnpCallback, IPnpCallbackSelfManagedIo, IPnpCallbackHardware, IFileCallbackCleanup и IFileCallbackClose . Затем платформа уведомляет драйвер при возникновении событий очистки и закрытия и Plug and Play (PnP) и управления питанием (PM). Дополнительные сведения о поддержке PnP и PM см. в разделе PnP и управление питанием в драйверах на основе UMDF.