DRIVER_PROXY_FEATURE_FLAGS unión (wdm.h)

La estructura DRIVER_PROXY_FEATURE_FLAGS contiene marcas de características que indican la disponibilidad y el estado de la funcionalidad DriverProxy para el sistema y el controlador actuales.

Syntax

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

Conjunto completo de marcas de características como un único valor de ULONG . Esto proporciona acceso a todas las marcas como un entero de 32 bits para facilitar la inicialización, la comparación o el almacenamiento.

Enabled

Marca de un solo bit que indica si la funcionalidad DriverProxy está habilitada y disponible. Cuando este bit se establece en 1, las API de DriverProxy, como IoCreateDriverProxyExtension y IoRegisterDriverProxyEndpoints , se pueden usar correctamente. Cuando este bit es 0, la funcionalidad DriverProxy no está disponible.

Reserved

Bits reservados para uso futuro. Estos bits no se usan actualmente y los controladores deben omitirlos. Están reservados para una posible expansión futura de las marcas de características driverProxy.

Observaciones

IoGetDriverProxyFeatures usa esta estructura para devolver información sobre si se admite y habilita la funcionalidad intercambiable en caliente driverProxy. Los controladores deben llamar a esta función para recuperar la estructura y comprobar la marca Enabled antes de intentar usar las API driverProxy.

La marca Enabled se establece en función de varias condiciones del sistema, entre las que se incluyen:

• El kernel seguro debe estar en ejecución.
• El sistema debe configurarse para las operaciones DriverProxy.
• El controlador no debe excluirse de la funcionalidad DriverProxy a través de la configuración del Registro.
• DriverProxy no debe estar deshabilitado globalmente

Los controladores deben inicializar esta estructura en cero antes de pasarla a IoGetDriverProxyFeatures para asegurarse de que los bits no inicializados no contengan valores aleatorios.

Requisitos

Consulte también

IoGetDriverProxyFeatures

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints