Condividi tramite


struttura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY (ndis.h)

La struttura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY specifica una matrice di porte di destinazione del commutatore estendibile Hyper-V per un pacchetto. Ogni elemento nella matrice viene formattato come struttura NDIS_SWITCH_PORT_DESTINATION .

Queste informazioni sono contenute nei dati fuori banda (OOB) della struttura NET_BUFFER_LIST del pacchetto.

Sintassi

typedef struct _NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY {
  NDIS_OBJECT_HEADER Header;
  UINT32             ElementSize;
  UINT32             NumElements;
  UINT32             NumDestinations;
  PVOID              FirstElement;
} NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY, *PNDIS_SWITCH_FORWARDING_DESTINATION_ARRAY;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il membro Type di Header deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY , il membro Revision di Header deve essere impostato sul valore seguente:

NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY_REVISION_1.

ElementSize

Valore ULONG che specifica le dimensioni, in byte, di ogni elemento NDIS_SWITCH_PORT_DESTINATION che segue la struttura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY .

NumElements

Valore ULONG che specifica il numero totale di elementi NDIS_SWITCH_PORT_DESTINATION nella struttura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY .

Il valore del membro NumElements specifica il numero di elementi attualmente utilizzati NDIS_SWITCH_PORT_DESTINATION (come specificato dal membro NumDestinations ) più il numero di elementi disponibili per le nuove porte di destinazione. Il numero di elementi NDIS_SWITCH_PORT_DESTINATION inutilizzati nella struttura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY viene calcolato da (NumElements - NumDestinations).

NumDestinations

Valore ULONG che specifica il numero di elementi NDIS_SWITCH_PORT_DESTINATION nella struttura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY che specificano le destinazioni di porta.

Nota Se NumElements è impostato su zero, questo membro viene ignorato.
 

FirstElement

Puntatore al primo elemento NDIS_SWITCH_PORT_DESTINATION nel buffer contenente la struttura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY e tutti i relativi elementi.

Commenti

L'estensione del commutatore estendibile può eseguire le operazioni seguenti con le porte di destinazione nella struttura NET_BUFFER_LIST di un pacchetto:

Le estensioni del commutatore estendibile possono usare la macro NDIS_SWITCH_PORT_DESTINATION_AT_ARRAY_INDEX per accedere agli elementi NDIS_SWITCH_PORT_DESTINATION in una matrice di NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY .

Requisiti

Requisito Valore
Client minimo supportato Supportato in NDIS 6.30 e versioni successive.
Intestazione ndis.h (include Ndis.h)

Vedi anche

Aggiunta di dati della porta di destinazione del commutatore estendibile a un pacchetto

Esclusione del recapito dei pacchetti alle porte di destinazione del commutatore estendibile

Inoltro delle estensioni

GetNetBufferListDestinations

Inoltro ibrido

NDIS_OBJECT_HEADER

NDIS_SWITCH_PORT_DESTINATION

NDIS_SWITCH_PORT_DESTINATION_AT_ARRAY_INDEX

NET_BUFFER_LIST

Panoramica del commutatore estendibile Hyper-V

UpdateNetBufferListDestinations