NdisFGetOptionalSwitchHandlers-Funktion (ndis.h)

  • Artikel

Erweiterungen für erweiterbare Hyper-V-Switches rufen die NdisFGetOptionalSwitchHandlers-Funktion auf, um eine Liste von Zeigern auf die Hyper-V-Handlerfunktionen für erweiterbare Switches abzurufen.

Syntax

NDIS_STATUS NdisFGetOptionalSwitchHandlers(
  [in]      NDIS_HANDLE                    NdisFilterHandle,
  [out]     PNDIS_SWITCH_CONTEXT           NdisSwitchContext,
  [in, out] PNDIS_SWITCH_OPTIONAL_HANDLERS NdisSwitchHandlers
);

Parameter

[in] NdisFilterHandle

Das NDIS-Handle, das dieses Filtermodul identifiziert. Wenn NDIS die FilterAttach-Funktion der Erweiterung aufgerufen hat, hat sie dieses Handle im NdisFilterHandle-Parameter übergeben.

[out] NdisSwitchContext

Ein Zeiger auf den NDIS_SWITCH_CONTEXT Wert, der das erweiterbare Switchmodul identifiziert, an das die Erweiterung angefügt ist. Wenn die Erweiterung eine erweiterbare Switchhandlerfunktion aufruft, muss sie den NdisSwitchContext-Parameter auf den Wert dieses Handles festlegen.

[in, out] NdisSwitchHandlers

Ein Zeiger auf eine aufruferseitig zugeordnete NDIS_SWITCH_OPTIONAL_HANDLERS-Struktur . Wenn der Aufruf erfolgreich ist, enthält diese Struktur eine Liste von Zeigern auf die erweiterbaren Switchhandlerfunktionen.

Weitere Informationen zu diesen Handlerfunktionen finden Sie unter Hyper-V Extensible Switch Handler Functions.

Hinweis Bevor die Erweiterung NdisFGetOptionalSwitchHandlers aufruft, muss sie den Headermember der NDIS_SWITCH_OPTIONAL_HANDLERS-Struktur initialisieren.
 

Rückgabewert

Wenn der Aufruf erfolgreich ist, gibt NdisFGetOptionalSwitchHandlers NDIS_STATUS_SUCCESS zurück. Andernfalls wird NDIS_STATUS_NOT_SUPPORTED zurückgegeben, wenn die erweiterbare Switcherweiterung nicht an die zugrunde liegende erweiterbare Switchkomponente gebunden ist.

Hinweise

Die Erweiterung ruft die NdisFGetOptionalSwitchHandlers-Funktion aus ihrer FilterAttach-Funktion auf.

Wenn die Erweiterung mit mehreren FilterMediaTypes INF-Einträgen installiert ist, kann die Erweiterung durch den Aufruf von NdisFGetOptionalSwitchHandlers bestimmen, ob sie für den erweiterbaren Switch oder einen physischen Netzwerkadapter gebunden und an den Treiberstapel angefügt ist. Wenn der Aufruf NDIS_STATUS_SUCCESS zurückgibt, wird die Erweiterung innerhalb des erweiterbaren Switchtreiberstapels angefügt. Wenn der Aufruf NDIS_STATUS_NOT_SUPPORTED zurückgibt, wird die Erweiterung innerhalb des Treiberstapels für einen physischen Netzwerkadapter angefügt.

Weitere Informationen zu FilterMediaTypes INF-Einträgen für erweiterbare Switcherweiterungen finden Sie unter INF-Anforderungen für Hyper-V Extensible Switch-Erweiterungen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.30 und höher.
Zielplattform Universell
Header ndis.h (include Ndis.h)
Bibliothek Ndis.lib
IRQL <= DISPATCH_LEVEL

Weitere Informationen

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS