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