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

Статья
03/22/2025

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

Метод WdfDeviceWdmGetPhysicalDevice извлекает PDO WDM физического устройства из стека устройств.

Синтаксис

PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
  [in] WDFDEVICE Device
);

Параметры

[in] Device

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

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

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

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

WdfDeviceWdmGetPhysicalDevice возвращает NULL, если вызывающий объект устройства управления предоставляется.

Замечания

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

Примеры

Пример кода, использующий WdfDeviceWdmGetPhysicalDevice, см. WdfDeviceWdmGetAttachedDevice.

Требования

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

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