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 proporciona NDIS en el parámetro NdisBindingHandle de de NdisOpenAdapterEx. Este identificador identifica el enlace que NDIS debe cerrar.
Valor devuelto
NdisCloseAdapterEx devuelve uno de los siguientes valores de estado:
| Código devuelto | Descripción |
|---|---|
|
NdisCloseAdapterEx cerrar 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 de protocolo función ProtocolCloseAdapterCompleteEx una vez completada la operación. |
Observaciones
Normalmente, un controlador de protocolo 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 miniport 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 antes de llamar a NdisCloseAdapterEx.
En cuanto el controlador llama a NdisCloseAdapterEx, el identificador obtenido del función NdisOpenAdapterEx en el parámetro NdisBindingHandle deja de ser válido.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Se admite en NDIS 6.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | Irql_Protocol_Driver_Function(ndis) |