Функция WdfDeviceWdmGetDeviceObject (wdfdevice.h)

Статья
03/22/2025

[Применимо только к KMDF]

Метод WdfDeviceWdmGetDeviceObject возвращает объект устройства модели драйвера Windows (WDM), связанный с указанным объектом устройства платформы.

Синтаксис

PDEVICE_OBJECT WdfDeviceWdmGetDeviceObject(
  WDFDEVICE Device
);

Параметры

Device

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

Возвращаемое значение

WdfDeviceWdmGetDeviceObject возвращает указатель на структуру DEVICE_OBJECT.

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Замечания

Указатель, который возвращает метод WdfDeviceWdmGetDeviceObject, действителен до удаления объекта устройства платформы. Если драйвер предоставляет функцию EvtCleanupCallback для объекта устройства платформы, указатель действителен до возврата функции обратного вызова.

Примеры

В следующем примере кода создается сообщение трассировки, содержащее указатели на объекты устройства WDM, представляющие PDO и FDO устройства.

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            AMCC_TRACE_INIT,
            "PDO 0x%p, FDO 0x%p",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device)
            );

Требования

Требование	Ценность
целевая платформа	универсальный
минимальная версия KMDF	1.0
Заголовок	wdfdevice.h (include Wdf.h)
Библиотека	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	<=DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WdfDeviceWdmGetPhysicalDevice

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