NDIS_SWITCH_FREE_NET_BUFFER_LIST_FORWARDING_CONTEXT funzione di callback (ndis.h)

La funzione FreeNetBufferListForwardingContext rilascia le risorse nel contesto di inoltro estendibile del commutatore out-of-band (OOB) di una struttura NET_BUFFER_LIST . Questi dati sono stati usati per le operazioni di invio o ricezione in un commutatore estendibile Hyper-V ed è stato allocato in precedenza chiamando la funzione AllocateNetBufferListForwardingContext .

Sintassi

NDIS_SWITCH_FREE_NET_BUFFER_LIST_FORWARDING_CONTEXT NdisSwitchFreeNetBufferListForwardingContext;

void NdisSwitchFreeNetBufferListForwardingContext(
  [in]      NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in, out] PNET_BUFFER_LIST NetBufferList
)
{...}

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 .

[in, out] NetBufferList

Puntatore a un elenco collegato di strutture NET_BUFFER_LIST .

Nota Questa struttura deve contenere un contesto di inoltro del commutatore estendibile allocato in precedenza chiamando la funzione AllocateNetBufferListForwardingContext .

 

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 può originare operazioni di invio di pacchetti all'interno del percorso dati del commutatore estendibile. Ad esempio, l'estensione può inviare pacchetti a qualsiasi porta sul commutatore estendibile. Per altre informazioni su questo percorso dati, vedere Percorso dati del commutatore estendibile Hyper-V.

Se l'estensione del commutatore estendibile ha origine un'operazione di invio di pacchetti, l'estensione deve chiamare la funzione AllocateNetBufferListForwardingContext . Questa funzione alloca e inizializza il contesto di inoltro per la struttura di NET_BUFFER_LIST specificata. Per altre informazioni su questo contesto, vedere Contesto di inoltro del commutatore estendibile Hyper-V.

Al termine dell'operazione di invio, l'estensione deve chiamare la funzione FreeNetBufferListForwardingContext per deallocare il contesto di inoltro.

Nota L'estensione deve chiamare la funzione FreeNetBufferListForwardingContext al termine dell'operazione di invio. L'estensione deve eseguire questa operazione indipendentemente dal fatto che aggiunse la struttura NET_BUFFER_LIST del pacchetto a un elenco lookaside o chiami NdisFreeNetBufferList per restituire la struttura a un pool.

 

Per altre informazioni su come originare le operazioni di invio, vedere Filtrare le operazioni di invio e ricezione del modulo.

Nota Se il parametro NetBufferList contiene un puntatore a un elenco collegato di più strutture NET_BUFFER_LIST , solo la prima struttura NET_BUFFER_LIST nell'elenco ha il relativo contesto di inoltro deallocato.

 

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

Vedi anche

AllocateNetBufferListForwardingContext

NET_BUFFER_LIST

NdisFGetOptionalSwitchHandlers

NdisFreeNetBufferList