Compartir a través de


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

NDIS llama a la función de controlador MiniportCancelIdleNotification para notificar al controlador de miniportar que NDIS ha detectado actividad en el adaptador de red suspendido. Debido a esto, NDIS cancela la notificación inactiva para que el adaptador de red se 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 miniporta asignó en su función MiniportInitializeEx. El controlador de miniporte usa este área de contexto para mantener la información de estado de un adaptador de red.

Valor devuelto

Ninguno

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 del controlador de miniporte MiniportIdleNotification 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 baja potencia, NDIS puede cancelar la notificación de inactividad pendiente si se cumple alguna de las condiciones siguientes:

  • Un protocolo excesivo o un controlador de filtro emite una solicitud de envío de paquetes o una solicitud OID al controlador de miniport.
  • El adaptador subyacente indica 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 miniporte cancela primero los paquetes de solicitud de E/S (IRP) específicos del bus que pueda haber emitido previamente para la notificación inactiva. Por último, el controlador de minipuerto llama a NdisMIdleNotificationComplete para completar la notificación inactiva.

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

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

Requisitos

Requisito Valor
cliente mínimo admitido Compatible con NDIS 6.30 y versiones posteriores.
de la plataforma de destino de Windows
encabezado de ndis.h (incluya Ndis.h)
irQL PASSIVE_LEVEL

Consulte también

ioCancelIrp

miniportIdleNotification

NdisMIdleNotificationComplete