Функция 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);

Требования

См. также

WdfDeviceMiniportCreate