NDIS_SWITCH_REFERENCE_SWITCH_NIC funzione di callback (ndis.h)

Articolo
02/07/2025

La funzione ReferenceSwitchNic incrementa il contatore di riferimento del commutatore estendibile Hyper-V per una scheda di rete connessa a una porta del 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 switch 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] SwitchPortId

Valore NDIS_SWITCH_PORT_ID che contiene l'identificatore univoco della porta del 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 del commutatore estendibile.

Per altre informazioni sui valori di 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 con 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 Hyper-V stati della porta del commutatore estendibile e della scheda di rete.

Valore restituito

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

Osservazioni

L'estensione del commutatore estendibile chiama ReferenceSwitchNic per incrementare un contatore di riferimento per una scheda di rete connessa a una porta del commutatore estendibile. Mentre il contatore di riferimento ha un valore diverso da zero, il bordo del protocollo dell'opzione estendibile non eseguirà una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_NIC_DELETE per eliminare la connessione all'adattatore.

Dopo che l'estensione chiama ReferenceSwitchNic, deve chiamare DereferenceSwitchNic per decrementare il contatore di riferimento dell'opzione estendibile.

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

Inoltra una richiesta OID OID_SWITCH_NIC_REQUEST sul percorso di controllo del 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 di controllo del commutatore estendibile da una scheda esterna sottostante.
Per altre informazioni, vedere Gestione delle indicazioni di stato NDIS da schede di rete fisiche.

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

L'estensione chiama referenceSwitchNic dopo che la connessione alla scheda di rete ha raggiunto lo stato connessione alla scheda di rete creata. L'estensione non deve chiamare referenceSwitchNic dopo che la connessione ha raggiunto la scheda di rete disconnessa o scheda di rete eliminata stati. Per altre informazioni su questi stati, vedere Hyper-V stati della porta del commutatore estendibile e della 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 dell'interruttore estendibile emette 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.

Fabbisogno

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