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

Artículo
02/07/2025

La función ReferenceSwitchNic incrementa el contador de referencia de conmutador extensible Hyper-V para un adaptador de red conectado a un puerto de conmutador extensible.

Sintaxis

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

Parámetros

[in] NdisSwitchContext

Valor NDIS_SWITCH_CONTEXT que contiene el identificador del módulo de conmutador extensible al que se adjunta la extensión de conmutador extensible 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 del conmutador extensible.

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

Nota Este parámetro debe especificar el valor de índice de un adaptador de red que se encuentra en un estado conectado. No se pueden especificar los valores de índice de los adaptadores de red que se encuentran en un estado creado o desconectado. Para obtener más información sobre los estados de conexión de red, consulte Hyper-V puerto de conmutador extensible y estados del adaptador de red.

Valor devuelto

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

Observaciones

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

Una vez que la extensión llama a ReferenceSwitchNic, debe llamar a DereferenceSwitchNic para disminuir el contador de referencia de conmutador extensible.

La extensión debe llamar a ReferenceSwitchNic antes de realizar las siguientes operaciones:

Reenvía una solicitud OID de OID_SWITCH_NIC_REQUEST a través de la ruta de acceso del control de conmutador extensible a un adaptador de red físico subyacente.
Para obtener más información, consulte administración de solicitudes OID a adaptadores de red físicos.
Reenvía una indicación de estado de NDIS_STATUS_SWITCH_NIC_STATUS a través de la ruta de acceso del control de conmutador extensible desde un adaptador externo subyacente.
Para obtener más información, consulte Administración de indicaciones de estado NDIS de adaptadores de red físicos.

Nota La extensión no debe llamar a ReferenceSwitchNic al reenviar paquetes a través de la ruta de acceso de datos de conmutador extensible. La interfaz de conmutador extensible administra sus propios contadores de referencia para los paquetes que se reenvía a los puertos y las conexiones del adaptador de red a través de la ruta de acceso de datos.

La extensión llama a ReferenceSwitchNic después de que la conexión del adaptador de red haya alcanzado la conexión del adaptador de red creado estado. La extensión no debe llamar a ReferenceSwitchNic después de que la conexión haya alcanzado el adaptador de red desconectado o estados de adaptador de red eliminados. Para obtener más información sobre estos estados, vea Hyper-V estados de adaptador de red y puerto de conmutador extensible.

Nota Cuando la extensión llama a ReferenceSwitchNic, no tiene que sincronizar la llamada con su código que controla las solicitudes OID. Como resultado, es posible que la extensión llame a ReferenceSwitchNic mientras que el borde del protocolo del conmutador extensible emite una solicitud OID de OID_SWITCH_NIC_DISCONNECT. Sin embargo, si la llamada a ReferenceSwitchNic se completa con NDIS_STATUS_SUCCESS, la extensión todavía puede reenviar OID_SWITCH_NIC_REQUEST solicitud OID o NDIS_STATUS_SWITCH_NIC_STATUS indicaciones de estado después de controlar la solicitud OID de OID_SWITCH_NIC_DISCONNECT.

Requisitos

Requisito	Valor
cliente mínimo admitido	Compatible con NDIS 6.30 y versiones posteriores.
de la plataforma de destino de	Escritorio
encabezado de	ndis.h (incluya Ndis.h)
irQL	<= DISPATCH_LEVEL