Функция IoGetDriverProxyExtensionFromDriverObject (wdm.h)

Функция IoGetDriverProxyExtensionFromDriverObject извлекает расширение DriverProxy, принадлежащее указанному объекту драйвера.

Синтаксис

PDRIVER_PROXY_EXTENSION IoGetDriverProxyExtensionFromDriverObject(
  PDRIVER_OBJECT DriverObject
);

Параметры

DriverObject

[in] Указатель на DRIVER_OBJECT , принадлежащий расширению DriverProxy для получения.

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

IoGetDriverProxyExtensionFromDriverObject возвращает указатель на расширение DriverProxy, принадлежающее указанному объекту драйвера, или NULL, если объект драйвера не имеет связанного расширения DriverProxy.

Замечания

Эта функция предоставляет простой способ получения существующего расширения DriverProxy, созданного ранее с помощью IoCreateDriverProxyExtension и связанного с объектом драйвера, без необходимости хранить указатель расширения отдельно. Функция часто используется, когда драйверу необходимо получить доступ к расширению DriverProxy из разных частей кода.

Функция может вызываться на любом уровне IRQL и не выполняет никаких операций выделения памяти или сложных операций.

Если поле DriverExtension объекта драйвера равно NULL, функция вернет ЗНАЧЕНИЕ NULL и может активировать утверждение в отладочных сборках.

Требования

См. также

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints

DRIVER_OBJECT