NDIS_SWITCH_DEREFERENCE_SWITCH_NIC función de devolución de llamada (ndis.h)

  • Artículo

La función DereferenceSwitchNic disminuye el contador de referencia de conmutador extensible de Hyper-V para un adaptador de red conectado a un puerto de conmutador extensible. El contador de referencia se incrementó a través de una llamada anterior a ReferenceSwitchNic.

Sintaxis

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
)
{...}

Parámetros

[in] NdisSwitchContext

Valor NDIS_SWITCH_CONTEXT que contiene el identificador del módulo de conmutador extensible al que está asociada la extensión de conmutador extensible de Hyper-V. Cuando la extensión llama a NdisFGetOptionalSwitchHandlers, este identificador se devuelve a través del parámetro NdisSwitchContext .

[in] SwitchPortId

Valor NDIS_SWITCH_PORT_ID que contiene el identificador único del puerto de conmutador extensible al que está conectado el adaptador de red virtual.

[in] SwitchNicIndex

Valor de NDIS_SWITCH_NIC_INDEX que especifica el índice del adaptador de red virtual para el que se va a incrementar el contador de referencia de conmutador extensible.

Para obtener más información sobre los valores de NDIS_SWITCH_NIC_INDEX, vea Valores de índice del adaptador de red.

Valor devuelto

Si la llamada se realiza correctamente, la función devuelve NDIS_STATUS_SUCCESS. De lo contrario, devuelve un código de error NDIS_STATUS_Xxx definido en Ndis.h.

Comentarios

La extensión de conmutador extensible llama a DereferenceSwitchNic para disminuir el contador de referencia de un adaptador de red que está conectado a un puerto de conmutador extensible. Aunque el contador de referencia de conmutador extensible tiene un valor distinto de cero, el borde del protocolo del conmutador extensible no emitirá una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_NIC_DELETE para eliminar la conexión al adaptador.

La extensión debe llamar a DereferenceSwitchNic si anteriormente había llamado ReferenceSwitchNic para una conexión de adaptador de red.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite en NDIS 6.30 y versiones posteriores.
Plataforma de destino Escritorio
Encabezado ndis.h (incluya Ndis.h)
IRQL <= DISPATCH_LEVEL

Consulte también

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic