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