estructura NDIS_SWITCH_OPTIONAL_HANDLERS (ndis.h)

Artículo
02/26/2024

La estructura NDIS_SWITCH_OPTIONAL_HANDLERS especifica los punteros a las funciones del controlador de conmutador extensible de Hyper-V. Una extensión de conmutador extensible puede llamar a estas funciones.

Sintaxis

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;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_SWITCH_OPTIONAL_HANDLERS . Este miembro tiene formato de estructura NDIS_OBJECT_HEADER .

El miembro Type de Header debe establecerse en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_SWITCH_OPTIONAL_HANDLERS , el miembro Revision de Header debe establecerse en el siguiente valor:

NDIS_SWITCH_OPTIONAL_HANDLERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1.

AllocateNetBufferListForwardingContext

Puntero a la función AllocateNetBufferListForwardingContext .

FreeNetBufferListForwardingContext

Puntero a la función FreeNetBufferListForwardingContext .

SetNetBufferListSource

Puntero a la función SetNetBufferListSource .

AddNetBufferListDestination

Puntero a la función AddNetBufferListDestination .

GrowNetBufferListDestinations

Puntero a la función GrowNetBufferListDestinations .

GetNetBufferListDestinations

Puntero a la función GetNetBufferListDestinations .

UpdateNetBufferListDestinations

Puntero a la función UpdateNetBufferListDestinations .

CopyNetBufferListInfo

Puntero a la función CopyNetBufferListInfo .

ReferenceSwitchNic

Puntero a la función ReferenceSwitchNic .

DereferenceSwitchNic

Puntero a la función DereferenceSwitchNic .

ReferenceSwitchPort

Puntero a la función ReferenceSwitchPort .

DereferenceSwitchPort

Puntero a la función DereferenceSwitchPort .

ReportFilteredNetBufferLists

Puntero a la función ReportFilteredNetBufferLists .

SetNetBufferListSwitchContext

GetNetBufferListSwitchContext

SwitchPDReserved[NDIS_SWITCH_OPTIONAL_HANDLERS_PD_RESERVED_SIZE]

Comentarios

Las funciones de controlador de conmutador extensible proporcionan compatibilidad con las acciones de filtrado y reenvío que realiza una extensión de conmutador extensible. Estas acciones incluyen las siguientes:

Asigne o libere el contexto de reenvío. Estos datos se almacenan en los datos fuera de banda (OOB) de la estructura NET_BUFFER_LIST de un paquete. Para obtener más información sobre el contexto de reenvío, consulte Contexto de reenvío extensible de conmutador de Hyper-V.
Obtiene o establece los puertos de destino contenidos en el contexto de reenvío de un paquete.
Agregue puertos de destino al contexto de reenvío de un paquete.

Cuando la extensión de conmutador extensible llama a NdisFGetOptionalSwitchHandlers, el parámetro NdisSwitchHandlers contiene un puntero a una estructura de NDIS_SWITCH_OPTIONAL_HANDLERS . Normalmente, una extensión de conmutador extensible llama a NdisFGetOptionalSwitchHandlers desde su función FilterAttach .