NDIS_SWITCH_DEREFERENCE_SWITCH_NIC funzione di callback (ndis.h)

  • Articolo

La funzione DereferenceSwitchNic decrementa il contatore di riferimento del commutatore estendibile Hyper-V per una scheda di rete connessa a una porta del commutatore estendibile. Il contatore di riferimento è stato incrementato tramite una chiamata precedente a ReferenceSwitchNic.

Sintassi

NDIS_SWITCH_DEREFERENCE_SWITCH_NIC NdisSwitchDereferenceSwitchNic;

NDIS_STATUS NdisSwitchDereferenceSwitchNic(
  [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 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] 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 NDIS_SWITCH_NIC_INDEX, vedere Valori di indice 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 DereferenceSwitchNic per decrementare il contatore di riferimento per una scheda di rete connessa a una porta del commutatore estendibile. Anche se il contatore di riferimento dell'opzione estendibile ha un valore diverso da zero, il bordo del protocollo dell'opzione estendibile non emetterà una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_NIC_DELETE per eliminare la connessione alla scheda.

L'estensione deve chiamare DereferenceSwitchNic se in precedenza aveva chiamato ReferenceSwitchNic per una connessione alla scheda di rete.

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

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic