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

  • Статья

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