union DRIVER_PROXY_FEATURE_FLAGS (wdm.h)

La structure DRIVER_PROXY_FEATURE_FLAGS contient des indicateurs de fonctionnalité qui indiquent la disponibilité et l’état de la fonctionnalité DriverProxy pour le système actuel et le pilote.

Syntaxe

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

Ensemble complet d’indicateurs de fonctionnalité sous forme de valeur ULONG unique. Cela permet d’accéder à tous les indicateurs sous la forme d’un entier 32 bits pour faciliter l’initialisation, la comparaison ou le stockage.

Enabled

Indicateur mono bits qui indique si la fonctionnalité DriverProxy est activée et disponible. Lorsque ce bit est défini sur 1, les API DriverProxy telles que IoCreateDriverProxyExtension et IoRegisterDriverProxyEndpoints peuvent être utilisées avec succès. Lorsque ce bit est 0, la fonctionnalité DriverProxy n’est pas disponible.

Reserved

Bits réservés pour une utilisation ultérieure. Ces bits sont actuellement inutilisés et doivent être ignorés par les pilotes. Ils sont réservés à l’expansion future potentielle des indicateurs de fonctionnalités DriverProxy.

Remarques

Cette structure est utilisée par IoGetDriverProxyFeatures pour retourner des informations sur la prise en charge et l’activation des fonctionnalités permutables de DriverProxy. Les pilotes doivent appeler cette fonction pour récupérer la structure et vérifier l’indicateur Activé avant de tenter d’utiliser les API DriverProxy.

L’indicateur Activé est défini en fonction de plusieurs conditions système, notamment :

• Le noyau sécurisé doit être en cours d’exécution
• Le système doit être configuré pour les opérations DriverProxy
• Le pilote ne doit pas être exclu de la fonctionnalité DriverProxy via les paramètres de Registre
• DriverProxy ne doit pas être désactivé globalement

Les pilotes doivent initialiser cette structure sur zéro avant de le transmettre à IoGetDriverProxyFeatures pour vous assurer que les bits non initialisés ne contiennent pas de valeurs aléatoires.

Spécifications

Voir aussi

IoGetDriverProxyFeatures

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints