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

Функция IoGetDriverProxyFeatures получает флаги функций DriverProxy для текущей системы и указанного драйвера.

Эта функция позволяет драйверам определить, доступна ли функция DriverProxy и включена для конкретного экземпляра драйвера. DriverProxy обеспечивает функциональность драйвера с поддержкой горячей замены, позволяя драйверам регистрировать функции конечной точки, которые можно заменить во время выполнения без выгрузки драйвера.

Синтаксис

VOID IoGetDriverProxyFeatures(
  PDRIVER_OBJECT              DriverObject,
  PDRIVER_PROXY_FEATURE_FLAGS Flags
);

Параметры

DriverObject

[in, необязательный] Необязательный указатель на DRIVER_OBJECT для проверки поддержки DriverProxy. Если этот параметр имеет значение NULL, функция проверяет, включена ли DriverProxy для всех драйверов в системе.

Flags

[out] Указатель на структуру DRIVER_PROXY_FEATURE_FLAGS , которая получает флаги функции DriverProxy. Структура указывает, доступна ли функция DriverProxy и включена.

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

Эта функция не возвращает значение.

Замечания

Функция IoGetDriverProxyFeatures определяет доступность DriverProxy на основе нескольких факторов:

• Поддерживает ли система функции DriverProxy
• Выполняется ли безопасное ядро (требуется для DriverProxy)
• Исключение конкретного драйвера из операций DriverProxy с помощью параметров реестра
• Отключено ли DriverProxy глобально

Драйверы должны вызывать эту функцию перед попыткой использовать другие API DriverProxy, такие как IoCreateDriverProxyExtension или IoRegisterDriverProxyEndpoints.

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

Требования

См. также

DRIVER_PROXY_FEATURE_FLAGS

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints

DRIVER_OBJECT