NDIS_SWITCH_OPTIONAL_HANDLERS Struktur (ndis.h)

Artikel
02/07/2025

Die NDIS_SWITCH_OPTIONAL_HANDLERS Struktur gibt die Zeiger auf die Hyper-V erweiterbaren Switchhandlerfunktionen an. Diese Funktionen können von einer erweiterbaren Switcherweiterung aufgerufen werden.

Syntax

typedef struct _NDIS_SWITCH_OPTIONAL_HANDLERS {
  NDIS_OBJECT_HEADER                                              Header;
  NDIS_SWITCH_ALLOCATE_NET_BUFFER_LIST_FORWARDING_CONTEXT_HANDLER AllocateNetBufferListForwardingContext;
  NDIS_SWITCH_FREE_NET_BUFFER_LIST_FORWARDING_CONTEXT_HANDLER     FreeNetBufferListForwardingContext;
  NDIS_SWITCH_SET_NET_BUFFER_LIST_SOURCE_HANDLER                  SetNetBufferListSource;
  NDIS_SWITCH_ADD_NET_BUFFER_LIST_DESTINATION_HANDLER             AddNetBufferListDestination;
  NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS_HANDLER           GrowNetBufferListDestinations;
  NDIS_SWITCH_GET_NET_BUFFER_LIST_DESTINATIONS_HANDLER            GetNetBufferListDestinations;
  NDIS_SWITCH_UPDATE_NET_BUFFER_LIST_DESTINATIONS_HANDLER         UpdateNetBufferListDestinations;
  NDIS_SWITCH_COPY_NET_BUFFER_LIST_INFO_HANDLER                   CopyNetBufferListInfo;
  NDIS_SWITCH_REFERENCE_SWITCH_NIC_HANDLER                        ReferenceSwitchNic;
  NDIS_SWITCH_DEREFERENCE_SWITCH_NIC_HANDLER                      DereferenceSwitchNic;
  NDIS_SWITCH_REFERENCE_SWITCH_PORT_HANDLER                       ReferenceSwitchPort;
  NDIS_SWITCH_DEREFERENCE_SWITCH_PORT_HANDLER                     DereferenceSwitchPort;
  NDIS_SWITCH_REPORT_FILTERED_NET_BUFFER_LISTS_HANDLER            ReportFilteredNetBufferLists;
  NDIS_SWITCH_SET_NET_BUFFER_LIST_SWITCH_CONTEXT_HANDLER          SetNetBufferListSwitchContext;
  NDIS_SWITCH_GET_NET_BUFFER_LIST_SWITCH_CONTEXT_HANDLER          GetNetBufferListSwitchContext;
  PVOID                                                           SwitchPDReserved[NDIS_SWITCH_OPTIONAL_HANDLERS_PD_RESERVED_SIZE];
} NDIS_SWITCH_OPTIONAL_HANDLERS, *PNDIS_SWITCH_OPTIONAL_HANDLERS;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_SWITCH_OPTIONAL_HANDLERS Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

Das element TypeHeader muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_OPTIONAL_HANDLERS-Struktur anzugeben, muss das RevisionselementHeader- auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_OPTIONAL_HANDLERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Size Member auf NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1 fest.

AllocateNetBufferListForwardingContext

Ein Zeiger auf die AllocateNetBufferListForwardingContext Funktion.

FreeNetBufferListForwardingContext

Ein Zeiger auf die FreeNetBufferListForwardingContext--Funktion.

SetNetBufferListSource

Ein Zeiger auf die SetNetBufferListSource--Funktion.

AddNetBufferListDestination

Ein Zeiger auf die AddNetBufferListDestination Funktion.

GrowNetBufferListDestinations

Ein Zeiger auf die GrowNetBufferListDestinations Funktion.

GetNetBufferListDestinations

Ein Zeiger auf die GetNetBufferListDestinations--Funktion.

UpdateNetBufferListDestinations

Ein Zeiger auf die UpdateNetBufferListDestinations-Funktion.

CopyNetBufferListInfo

Ein Zeiger auf die CopyNetBufferListInfo-Funktion.

ReferenceSwitchNic

Ein Zeiger auf die ReferenceSwitchNic--Funktion.

DereferenceSwitchNic

Ein Zeiger auf die funktion DereferenceSwitchNic.

ReferenceSwitchPort

Ein Zeiger auf die ReferenceSwitchPort--Funktion.

DereferenceSwitchPort

Ein Zeiger auf die funktion DereferenceSwitchPort.

ReportFilteredNetBufferLists

Ein Zeiger auf die ReportFilteredNetBufferLists--Funktion.

SetNetBufferListSwitchContext

GetNetBufferListSwitchContext

SwitchPDReserved[NDIS_SWITCH_OPTIONAL_HANDLERS_PD_RESERVED_SIZE]

Bemerkungen

Die erweiterbaren Switchhandlerfunktionen bieten Unterstützung für Filter- und Weiterleitungsaktionen, die von einer erweiterbaren Switcherweiterung ausgeführt werden. Zu diesen Aktionen gehören:

Weisen Sie den Weiterleitungskontext zu, oder geben Sie den Weiterleitungskontext frei. Diese Daten werden in den Out-of-Band-Daten (OOB) der NET_BUFFER_LIST Struktur eines Pakets gespeichert. Weitere Informationen zum Weiterleitungskontext finden Sie unter Hyper-V Extensible Switch Forwarding Context.
Dient zum Abrufen oder Festlegen der Zielports, die im Weiterleitungskontext eines Pakets enthalten sind.
Fügen Sie Zielports zum Weiterleitungskontext eines Pakets hinzu.

Wenn die erweiterbare Switcherweiterung NdisFGetOptionalSwitchHandlersaufruft, enthält der NdisSwitchHandlers Parameter einen Zeiger auf eine NDIS_SWITCH_OPTIONAL_HANDLERS Struktur. Eine erweiterbare Switcherweiterung ruft in der Regel NdisFGetOptionalSwitchHandlers von der FilterAttach--Funktion auf.