DRIVER_PROXY_FEATURE_FLAGS Union (wdm.h)

Die DRIVER_PROXY_FEATURE_FLAGS-Struktur enthält Featurekennzeichnungen, die die Verfügbarkeit und den Status der DriverProxy-Funktionalität für das aktuelle System und den aktuellen Treiber angeben.

Syntax

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

Elemente

AsUlong

Der vollständige Satz von Featurekennzeichnungen als einzelner ULONG-Wert . Dies ermöglicht den Zugriff auf alle Flags als 32-Bit-Ganzzahl für einfache Initialisierung, Vergleich oder Speicher.

Enabled

Ein Single-Bit-Flag, das angibt, ob driverProxy-Funktionalität aktiviert und verfügbar ist. Wenn dieses Bit auf 1 festgelegt ist, können DriverProxy-APIs wie IoCreateDriverProxyExtension und IoRegisterDriverProxyEndpoints erfolgreich verwendet werden. Wenn dieses Bit 0 ist, ist die DriverProxy-Funktionalität nicht verfügbar.

Reserved

Reservierte Bits für die zukünftige Verwendung. Diese Bits werden derzeit nicht verwendet und sollten von Treibern ignoriert werden. Sie sind für die potenzielle zukünftige Erweiterung von DriverProxy-Featurekennzeichnungen reserviert.

Bemerkungen

Diese Struktur wird von IoGetDriverProxyFeatures verwendet, um Informationen darüber zurückzugeben, ob DriverProxy hot-swappable Funktionalität unterstützt und aktiviert wird. Treiber sollten diese Funktion aufrufen, um die Struktur abzurufen und das Flag "Enabled " zu überprüfen, bevor Sie versuchen, DriverProxy-APIs zu verwenden.

Das Flag "Aktiviert " wird basierend auf mehreren Systembedingungen festgelegt, darunter:

• Der sichere Kernel muss ausgeführt werden.
• Das System muss für DriverProxy-Vorgänge konfiguriert werden.
• Der Treiber darf nicht von der DriverProxy-Funktionalität über Registrierungseinstellungen ausgeschlossen werden.
• DriverProxy darf nicht global deaktiviert werden

Treiber sollten diese Struktur auf Null initialisieren, bevor sie an IoGetDriverProxyFeatures übergeben werden, um sicherzustellen, dass alle nicht initialisierten Bits keine Zufallswerte enthalten.

Anforderungen

Siehe auch

IoGetDriverProxyFeatures

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints