MINIPORT_CANCEL_IDLE_NOTIFICATION función de devolución de llamada (ndis.h)

  • Artículo

NDIS llama a la función de controlador MiniportCancelIdleNotification para notificar al controlador de minipuerto que NDIS ha detectado actividad en el adaptador de red suspendido. Por este motivo, NDIS cancela la notificación inactiva para que el adaptador de red pueda pasar a un estado de energía completa.

Sintaxis

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

void MiniportCancelIdleNotification(
  [in] NDIS_HANDLE MiniportAdapterContext
)
{...}

Parámetros

[in] MiniportAdapterContext

Identificador de un área de contexto que el controlador de minipuerto asignó en su función MiniportInitializeEx . El controlador de minipuerto usa este área de contexto para mantener la información de estado de un adaptador de red.

Valor devuelto

None

Observaciones

La función de controlador MiniportCancelIdleNotification es necesaria para los controladores de miniporte que admiten la interfaz de suspensión selectiva de NDIS. Para obtener más información sobre cómo el controlador registra sus funciones de controlador de suspensión selectiva, consulte Registro de funciones de controlador de suspensión selectiva de NDIS.

NDIS llama a la función de controlador MiniportIdleNotification del controlador de miniporte para iniciar una operación de suspensión selectiva de NDIS en un adaptador de red inactivo. Una vez suspendido y pasado el adaptador de red a un estado de bajo consumo, NDIS puede cancelar la notificación de inactividad pendiente si se cumple alguna de las condiciones siguientes:

  • Un protocolo o controlador de filtro excesivo emite una solicitud de paquete de envío o una solicitud de OID al controlador de minipuerto.
  • El adaptador subyacente señala un evento de reactivación, como recibir un paquete que coincida con un patrón wake-on-LAN (WOL) o detectar un cambio en su estado de conexión multimedia.
NDIS cancela la notificación inactiva llamando a MiniportCancelIdleNotification. Cuando se llama a esta función de controlador, el controlador de minipuerto cancela primero los paquetes de solicitud de E/S específicos del bus (IRP) que puede haber emitido previamente para la notificación inactiva. Por último, el controlador de minipuerto llama a NdisMIdleNotificationComple para completar la notificación inactiva.

Para obtener más información sobre cómo NDIS cancela la notificación de inactividad, vea Cancelar la notificación de suspensión inactiva selectiva de NDIS.

Para obtener instrucciones sobre cómo implementar la función de controlador MiniportCancelIdleNotification y las rutinas de finalización de IRP, consulte Implementación de una función de controlador MiniportCancelIdleNotification.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite en NDIS 6.30 y versiones posteriores.
Plataforma de destino Windows
Encabezado ndis.h (incluya Ndis.h)
IRQL PASSIVE_LEVEL

Consulte también

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComple