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