Функция WdfDriverWdmGetDriverObject (wdfdriver.h)

  • Статья

[Относится только к KMDF]

Метод WdfDriverWdmGetDriverObject извлекает указатель на объект драйвера модели драйвера Windows (WDM), связанный с указанным объектом драйвера платформы.

Синтаксис

PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
  [in] WDFDRIVER Driver
);

Параметры

[in] Driver

Дескриптор объекта драйвера платформы драйвера, который драйвер получил при предыдущем вызове WdfDriverCreate или WdfGetDriver.

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

WdfDriverWdmGetDriverObject возвращает указатель на структуру DRIVER_OBJECT . Системная ошибка проверка возникает, если дескриптор драйвера недопустим.

Комментарии

Указатель, возвращаемый методом WdfDriverWdmGetDriverObject , действителен до удаления объекта драйвера платформы. Если драйвер предоставляет функцию EvtCleanupCallback для объекта драйвера платформы, указатель будет действителен до тех пор, пока функция обратного вызова не вернет значение .

Примеры

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

PDRIVER_OBJECT  pDrvObj;

pDrvObj = WdfDriverWdmGetDriverObject(Driver);

Требования

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

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

DRIVER_OBJECT

WdfDriverCreate

WdfGetDriver