Интерфейс 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 (т. е. включает, отключает или задает состояние по умолчанию), заданное набором методов 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 (include Wudfddi.h) |