NdisFGetOptionalSwitchHandlers-Funktion (ndis.h)
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.
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