NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS funzione di callback (ndis.h)

Articolo
02/26/2024

La funzione GrowNetBufferListDestinations aggiunge spazio per altre porte di destinazione del commutatore estendibile Hyper-V a un pacchetto specificato da una struttura NET_BUFFER_LIST .

Sintassi

NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS NdisSwitchGrowNetBufferListDestinations;

NDIS_STATUS NdisSwitchGrowNetBufferListDestinations(
  [in]  NDIS_SWITCH_CONTEXT NdisSwitchContext,
        PNET_BUFFER_LIST NetBufferList,
  [in]  UINT32 NumberOfNewDestinations,
  [out] PNDIS_SWITCH_FORWARDING_DESTINATION_ARRAY *Destinations
)
{...}

Parametri

[in] NdisSwitchContext

Valore NDIS_SWITCH_CONTEXT che contiene l'handle del modulo di opzione estendibile a cui è collegata l'estensione del commutatore estendibile Hyper-V. Quando l'estensione chiama NdisFGetOptionalSwitchHandlers, questo handle viene restituito tramite il parametro NdisSwitchContext .

NetBufferList

Puntatore a un elenco collegato di strutture NET_BUFFER_LIST .

Nota Questa struttura deve contenere un contesto di inoltro del commutatore estendibile. Se l'estensione ha creato o clonato il pacchetto, deve aver allocato in precedenza questa struttura chiamando la funzione AllocateNetBufferListForwardingContext . Per altre informazioni sul contesto di inoltro del commutatore estendibile, vedere Contesto di inoltro del commutatore estendibile Hyper-V.

[in] NumberOfNewDestinations

Valore UINT32 che specifica il numero di nuove porte di destinazione da aggiungere per il pacchetto.

[out] Destinations

Puntatore a una struttura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY . Questa struttura specifica le porte di destinazione del commutatore estendibile del pacchetto.

Valore restituito

Se la chiamata ha esito positivo, la funzione restituisce NDIS_STATUS_SUCCESS. In caso contrario, restituisce un codice di errore NDIS_STATUS_Xxx definito in Ndis.h.

Commenti

L'estensione del commutatore estendibile chiama la funzione GrowNetBufferListDestinations per aggiungere spazio per le porte di destinazione per un pacchetto. Le destinazioni delle porte vengono specificate tramite una struttura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY .

Per altre informazioni su come aggiungere porte di destinazione a un pacchetto, vedere Aggiunta di dati della porta di destinazione del commutatore estendibile a un pacchetto.

Nota Se il parametro NetBufferList contiene un puntatore a un elenco collegato di più strutture NET_BUFFER_LIST , lo spazio per le porte di destinazione aggiuntive viene aggiunto solo alla prima struttura NET_BUFFER_LIST nell'elenco.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.30 e versioni successive.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL