Función NdisCloseAdapter (ndis.h)

  • Artículo

Nota NDIS 5. x está 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 Migración de controladores NDIS 5.x a NDIS 6.0.

NdisCloseAdapter libera el enlace establecido y los recursos asignados cuando el protocolo se llama 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 valores siguientes:

  • NDIS_STATUS_SUCCESS
    El enlace se cerró y se han liberado todos los recursos que pertenecen a ese enlace.

  • NDIS_STATUS_PENDING
    Cuando se realiza la operación de cierre, se controla de forma asincrónica una solicitud de adaptador cercano y se llamará a la función ProtocolCloseAdapterComplete del autor de la llamada.

[in] NdisBindingHandle

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

Valor devuelto

None

Observaciones

Valor devuelto: None

Normalmente, un controlador de protocolo llama a NdisCloseAdapter desde su función ProtocolUnbindAdapter . También puede llamar a NdisCloseAdapter desde su función 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 autor de la llamada debe considerar que el identificador de NdisBindingHandle no es válido. 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
  • Versión: no se admite para controladores NDIS 6.0 en Windows Vista. En su lugar, use NdisCloseAdapterEx. Compatible con controladores NDIS 5.1 en Windows Vista y Windows XP.

Requisitos

Requisito Valor
Header ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL

Consulte también