Compartir a través de

Función NdisCloseAdapter (ndis.h)

  • Artículo

Nota NDIS 5. x ha quedado en desuso y se sustituye por NDIS 6. x. Para el nuevo desarrollo de controladores NDIS, consulte Controladores de red a partir de Windows Vista. Para obtener información sobre cómo migrar NDIS 5. controladores x a NDIS 6. x, consulte Porting NDIS 5.x Drivers to NDIS 6.0.

NdisCloseAdapter libera el enlace establecido y los recursos asignados cuando el protocolo llamado NdisOpenAdapter.

Sintaxis

void NdisCloseAdapter(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisBindingHandle
);

Parámetros

[out] Status

Puntero a una variable proporcionada por el autor de la llamada en la que esta función devuelve el estado de la operación de cierre, que puede ser uno de los siguientes valores:

  • NDIS_STATUS_SUCCESS
    El enlace se cerró y se han liberado todos los recursos relacionados con ese enlace.

  • NDIS_STATUS_PENDING
    Se está administrando de forma asincrónica una solicitud de adaptador de cierre y se llamará a la funciónprotocolCloseAdapterComplete delautor de la llamada cuando se realice la operación de cierre.

[in] NdisBindingHandle

Especifica el identificador devuelto por NdisOpenAdapter que identifica el adaptador virtual o la NIC que se va a cerrar.

Valor devuelto

Ninguno

Observaciones

Valor devuelto: Ninguno

Normalmente, un controlador de protocolo llama a NdisCloseAdapter desde su función ProtocolUnbindAdapter. También puede llamar a NdisCloseAdapter desde su función de ProtocolBindAdapter, por ejemplo, si no pudo establecer un valor OID después de llamar a NdisOpenAdapter para configurar un enlace.

En cuanto un protocolo llama a NdisCloseAdapter, el controlador de NdisBindingHandle debe considerarse no válido por el autor de la llamada. Se trata de un error de programación para pasar este identificador en cualquier llamada posterior a una función NdisXxx.

  • Plataforma de destino: universal de
  • Versión: no se admite para controladores NDIS 6.0 en Windows Vista. Use NdisCloseAdapterEx en su lugar. Compatible con controladores NDIS 5.1 en Windows Vista y Windows XP.

Requisitos

Requisito Valor
encabezado de ndis.h (incluya Ndis.h)
biblioteca de Ndis.lib
irQL PASSIVE_LEVEL

Consulte también