Compartir a través de


Función NdisCloseAdapterEx (ndis.h)

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)

Consulte también

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolBindAdapterEx

ProtocolCloseAdapterCompleteEx

ProtocolUnbindAdapterEx