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 |
|---|---|
|
NdisCloseAdapterEx cerró correctamente el enlace al adaptador de miniport subyacente. |
|
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) |