Función NdisCloseAdapterEx (ndis.h)

Artículo
08/07/2023

Un controlador de protocolo llama a la función NdisCloseAdapterEx para liberar el enlace y los recursos que se asignaron cuando el controlador llamó a la función NdisOpenAdapterEx .

Sintaxis

NDIS_STATUS NdisCloseAdapterEx(
  [in] NDIS_HANDLE NdisBindingHandle
);

Parámetros

[in] NdisBindingHandle

Identificador que NDIS proporcionó en el parámetro NdisBindingHandle de NdisOpenAdapterEx. Este identificador identifica el enlace que debe cerrar NDIS.

Valor devuelto

NdisCloseAdapterEx devuelve uno de los siguientes valores de estado:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NdisCloseAdapterEx cerró correctamente el enlace al adaptador de miniport subyacente.
NDIS_STATUS_PENDING	NdisCloseAdapterEx no completó la operación de cierre y la operación se completará de forma asincrónica. NDIS llama al controlador del protocolo Función ProtocolCloseAdapterCompleteEx cuando se completa la operación.

Comentarios

Un controlador de protocolo normalmente llama a NdisCloseAdapterEx desde su Función ProtocolUnbindAdapterEx . El controlador también puede llamar a NdisCloseAdapterEx desde su función ProtocolBindAdapterEx . Por ejemplo, si el controlador no pudo establecer un valor de OID después de llamar a NdisOpenAdapterEx, puede llamar a NdisCloseAdapterEx desde su función ProtocolBindAdapterEx .

Si un controlador de protocolo debe cerrar un adaptador de minipuerto fuera del contexto de ProtocolUnbindAdapterEx o ProtocolBindAdapterEx, debe llamar a la función NdisUnbindAdapter .

Los controladores de protocolo deben esperar a que se completen todas las solicitudes de envío y OID que se originaron antes de llamar a NdisCloseAdapterEx.

En cuanto el controlador llama a NdisCloseAdapterEx, el identificador obtenido de la función NdisOpenAdapterEx en el parámetro NdisBindingHandle deja de ser válido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite en NDIS 6.0 y versiones posteriores.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	Irql_Protocol_Driver_Function(ndis)