NDIS_SWITCH_REFERENCE_SWITCH_NIC funzione di callback (ndis.h)

Articolo
08/07/2023

La funzione ReferenceSwitchNic incrementa il contatore di riferimento del commutatore estendibile Hyper-V per una scheda di rete connessa a una porta di commutatore estendibile.

Sintassi

NDIS_SWITCH_REFERENCE_SWITCH_NIC NdisSwitchReferenceSwitchNic;

NDIS_STATUS NdisSwitchReferenceSwitchNic(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId,
  [in] NDIS_SWITCH_NIC_INDEX SwitchNicIndex
)
{...}

Parametri

[in] NdisSwitchContext

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

[in] SwitchPortId

Valore NDIS_SWITCH_PORT_ID contenente l'identificatore univoco della porta di commutatore estendibile a cui è connessa la scheda di rete virtuale.

[in] SwitchNicIndex

Valore NDIS_SWITCH_NIC_INDEX che specifica l'indice della scheda di rete virtuale per cui deve essere incrementato il contatore di riferimento dell'interruttore estendibile.

Per altre informazioni sui valori NDIS_SWITCH_NIC_INDEX, vedere Valori di indice della scheda di rete.

Nota Questo parametro deve specificare il valore di indice di una scheda di rete in uno stato connesso. Non è possibile specificare i valori di indice per le schede di rete in uno stato creato o disconnesso. Per altre informazioni sugli stati di connessione di rete, vedere Stati della porta estendibile hyper-V e della scheda di rete.

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 ReferenceSwitchNic per incrementare un contatore di riferimento per una scheda di rete connessa a una porta di commutatore estendibile. Anche se il contatore di riferimento ha un valore diverso da zero, il bordo del protocollo dell'commutatore estendibile non emetterà una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_NIC_DELETE per eliminare la connessione alla scheda.

Dopo che l'estensione chiama ReferenceSwitchNic, deve chiamare DereferenceSwitchNic per decrerere il contatore di riferimento del commutatore estendibile.

L'estensione deve chiamare ReferenceSwitchNic prima di eseguire le operazioni seguenti:

Inoltra una richiesta OID OID_SWITCH_NIC_REQUEST sul percorso di controllo commutatore estendibile a una scheda di rete fisica sottostante.
Per altre informazioni, vedere Gestione delle richieste OID alle schede di rete fisiche.
Inoltra un'indicazione di stato NDIS_STATUS_SWITCH_NIC_STATUS sul percorso del controllo commutatore estendibile da una scheda esterna sottostante.
Per altre informazioni, vedere Gestione delle indicazioni sullo stato di NDIS da schede di rete fisiche.

Nota L'estensione non deve chiamare ReferenceSwitchNic durante l'inoltro di pacchetti sul percorso dati dell'commutatore estendibile. L'interfaccia del commutatore estendibile gestisce i propri contatori di riferimento per i pacchetti inoltrati alle porte e alle connessioni della scheda di rete nel percorso dati.

L'estensione chiama ReferenceSwitchNic dopo che la connessione della scheda di rete ha raggiunto lo stato creato dalla connessione della scheda di rete . L'estensione non deve chiamare ReferenceSwitchNic dopo che la connessione ha raggiunto gli stati eliminati della scheda di rete o della scheda di rete. Per altre informazioni su questi stati, vedere Hyper-V Extensible Switch Port and Network Adapter States ( Stati della porta estendibile Hyper-V e Scheda di rete).

Nota Quando l'estensione chiama ReferenceSwitchNic, non deve sincronizzare la chiamata con il codice che gestisce le richieste OID. Di conseguenza, è possibile che l'estensione chiami ReferenceSwitchNic mentre il bordo del protocollo del commutatore estendibile genera una richiesta OID di OID_SWITCH_NIC_DISCONNECT. Tuttavia, se la chiamata a ReferenceSwitchNic viene completata con NDIS_STATUS_SUCCESS, l'estensione può comunque inoltrare OID_SWITCH_NIC_REQUEST richiesta OID o NDIS_STATUS_SWITCH_NIC_STATUS indicazioni sullo stato dopo che gestisce la richiesta OID OID_SWITCH_NIC_DISCONNECT.

Requisiti

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