Интерфейс IWDFDevice (wudfddi.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]
Интерфейс IWDFDevice предоставляет объект устройства, который представляет собой устройство в системе.
Наследование
Интерфейс IWDFDevice наследуется от IWDFObject. IWDFDevice также имеет следующие типы элементов:
- Методы
Методы
Интерфейс IWDFDevice имеет следующие методы.
| IWDFDevice::AssignDeviceInterfaceState Метод AssignDeviceInterfaceState включает или отключает указанный экземпляр интерфейса устройства для устройства. |
| IWDFDevice::CommitPnpState Метод CommitPnpState фиксирует состояние свойства Plug and Play (PnP) (то есть включает, отключает или задает состояние по умолчанию), заданное методом IWDFDevice::SetPnpState. |
| IWDFDevice::ConfigureRequestDispatching Метод ConfigureRequestDispatching настраивает очередь запросов ввода-вывода указанного типа в указанную очередь ввода-вывода. |
| IWDFDevice::CreateDeviceInterface Метод CreateDeviceInterface создает экземпляр класса интерфейса устройства. |
| IWDFDevice::CreateIoQueue Метод CreateIoQueue настраивает очередь ввода-вывода по умолчанию, связанную с устройством, или создает вторичную очередь ввода-вывода для устройства. |
| IWDFDevice::CreateRequest Метод CreateRequest создает объект неформатированного запроса. |
| IWDFDevice::CreateSymbolicLink Метод CreateSymbolicLink создает символьную ссылку для устройства. |
| IWDFDevice::CreateWdfFile Метод CreateWdfFile создает объект файла для использования драйвером. |
| IWDFDevice::GetDefaultIoQueue Метод GetDefaultIoQueue извлекает интерфейс очереди ввода-вывода по умолчанию для устройства. |
| IWDFDevice::GetDefaultIoTarget Метод GetDefaultIoTarget извлекает интерфейс целевого объекта ввода-вывода по умолчанию для экземпляра устройства. |
| IWDFDevice::GetDriver Метод GetDriver извлекает интерфейс в родительский объект драйвера экземпляра устройства. |
| IWDFDevice::GetPnpState Метод GetPnpState определяет, включено ли заданное свойство Plug and Play (PnP) устройства (или задано состояние по умолчанию). |
| IWDFDevice::P ostEvent Метод PostEvent асинхронно уведомляет приложения, ожидающие указанного события от драйвера. |
| IWDFDevice::RetrieveDeviceInstanceId Метод RetrieveDeviceInstanceId извлекает идентификатор экземпляра устройства. |
| IWDFDevice::RetrieveDeviceName Метод RetrieveDeviceName извлекает имя базового устройства в режиме ядра. |
| IWDFDevice::RetrieveDevicePropertyStore Метод RetrieveDevicePropertyStore извлекает интерфейс хранилища свойств. Драйверы могут использовать метод для доступа к реестру. |
| IWDFDevice::SetPnpState Метод SetPnpState включает или отключает (или задает состояние по умолчанию) указанное свойство Plug and Play (PnP) устройства. |
Комментарии
Каждый объект устройства имеет родительский объект драйвера. Когда новое устройство поступает в систему, платформа вызывает функцию обратного вызова IDriverEntry::OnDeviceAdd родительского драйвера, чтобы уведомить драйвер о прибытии. Затем драйвер может вызвать метод IWDFDriver::CreateDevice , чтобы получить указатель на интерфейс IWDFDevice для нового объекта устройства.
Требования
| Требование | Значение |
|---|---|
| Дата окончания поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| Целевая платформа | Персональный компьютер |
| Минимальная версия UMDF | 1.5 |
| Верхняя часть | wudfddi.h (включая Wudfddi.h) |