объединение DRIVER_PROXY_FEATURE_FLAGS (wdm.h)

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

Синтаксис

typedef union _DRIVER_PROXY_FEATURE_FLAGS {
  ULONG  AsUlong;
  struct {
    ULONG Enabled : 1;
    ULONG Reserved : 31;
  };
} DRIVER_PROXY_FEATURE_FLAGS, *PDRIVER_PROXY_FEATURE_FLAGS;

Members

AsUlong

Полный набор флагов функций в виде одного значения ULONG . Это обеспечивает доступ ко всем флагам в виде 32-разрядного целого числа для простой инициализации, сравнения или хранения.

Enabled

Однобитовый флаг, указывающий, включена ли функция DriverProxy и доступна. Если для этого бита задано значение 1, API DriverProxy, такие как IoCreateDriverProxyExtension и IoRegisterDriverProxyEndpoints , можно успешно использовать. Если этот бит равен 0, функция DriverProxy недоступна.

Reserved

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

Замечания

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

Флаг включено устанавливается на основе нескольких системных условий, в том числе:

  • Необходимо запустить безопасное ядро
  • Система должна быть настроена для операций DriverProxy
  • Драйвер не должен быть исключен из функциональных возможностей DriverProxy с помощью параметров реестра
  • DriverProxy не должен быть глобально отключен

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

Требования

Требование Ценность
Header wdm.h

См. также

IoGetDriverProxyFeatures

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints

  • Last updated on