Поделиться через


Интерфейс 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)