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

  • Статья

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

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

Синтаксис

WDFDEVICE WdfWdmDeviceGetWdfDeviceHandle(
  [in] PDEVICE_OBJECT DeviceObject
);

Параметры

[in] DeviceObject

Указатель на структуру WDM DEVICE_OBJECT , созданную вызывающим драйвером.

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

Если указанный объект устройства WDM является допустимым, WdfWdmDeviceGetWdfDeviceHandle возвращает дескриптор связанному объекту устройства платформы. В противном случае метод возвращает значение NULL.

Комментарии

Структура WDM DEVICE_OBJECT, указанная драйвером для параметра DeviceObject , должна представлять объект устройства, созданный вызывающим драйвером. Например, структура не может представлять объекты устройства WDM, указанные драйвером в предыдущем вызове WdfDeviceMiniportCreate.

Примеры

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

WDFDEVICE  device;

device = WdfWdmDeviceGetWdfDeviceHandle(pWdmDeviceObject);

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfdevice.h (включая Wdf.h)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL <=DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

WdfDeviceMiniportCreate