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

Статья
02/29/2024

[Относится только к 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 (включая Wdf.h)
Библиотека	Wdf01000.sys (см. раздел Управление версиями библиотеки Платформы).
IRQL	<=DISPATCH_LEVEL
Правила соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также раздел

WdfDeviceWdmGetPhysicalDevice

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