Compartir a través de

Información general sobre las indicaciones de estado del motivo de reactivación de NDIS

  • Artículo

A partir de NDIS 6.30, los controladores de minipuerto emiten una indicación de estado del motivo de reactivación NDIS (NDIS_STATUS_PM_WAKE_REASON) para notificar a los controladores NDIS y sobre el motivo de un evento de reactivación del sistema. Si el adaptador de red genera un evento de reactivación, el controlador de minipuerto emite inmediatamente una indicación de estado NDIS de NDIS_STATUS_PM_WAKE_REASON cuando el adaptador de red se reanuda a un estado de energía completa.

Nota La compatibilidad con las indicaciones de estado del motivo de reactivación NDIS es opcional para los controladores de miniporte de banda ancha móvil (MB).

El controlador de minipuerto se configura con parámetros de administración de energía (PM) a través de una solicitud de conjunto de identificador de objeto (OID) de OID_PM_PARAMETERS. Esta solicitud de OID especifica los parámetros pm a través de una estructura de NDIS_PM_PARAMETERS .

La estructura NDIS_PM_PARAMETERS especifica los parámetros de los siguientes tipos de eventos de reactivación.

Eventos de reactivación de paquetes recibidos
El adaptador de red genera un evento de reactivación si recibe un paquete que coincide con un patrón wake-on-LAN (WOL). Los patrones WOL incluyen lo siguiente:

  • Patrones WOL independientes de medios, como paquetes mágicos o patrones de datos TCP/IP dentro de la carga del paquete. Por ejemplo, la estructura de NDIS_PM_PARAMETERS podría especificar un patrón WOL para un marco TCP SYN.

  • Patrones WOL específicos de medios, como un paquete de identificador de solicitud EAPOL o un mensaje de Servicio de mensajes cortos (SMS) de banda ancha móvil (MB).

  • Patrones comodín que coinciden con un filtro de recepción especificado a través de una solicitud de conjunto de OID de OID_GEN_CURRENT_PACKET_FILTER.

Nota Para este tipo de indicación de estado del motivo de reactivación, el adaptador de red debe poder guardar el paquete recibido. El controlador debe devolver el paquete recibido dentro de la indicación de estado.

Los patrones WOL se especifican a través del miembro EnabledWoLPacketPatterns de la estructura NDIS_PM_PARAMETERS .

Eventos de reactivación específicos de medios
El adaptador de red genera un evento de reactivación debido a un motivo específico del medio, como una desasociación de un punto de acceso 802.11 (AP) o la recepción de un mensaje de servicio de mensajes cortos (SMS) de banda ancha móvil (MB).

Los eventos de reactivación de este tipo se especifican a través del miembro MediaSpecificWakeUpEvents de la estructura NDIS_PM_PARAMETERS .

Eventos de reactivación independientes de medios
El adaptador de red genera un evento de reactivación debido a un motivo independiente del medio, como la conexión de medios o la desconexión.

Los eventos de reactivación de este tipo se especifican a través del miembro WakeUpFlags de la estructura NDIS_PM_PARAMETERS .

El controlador de minipuerto debe seguir estas directrices para las indicaciones de estado del motivo de reactivación NDIS:

  • Si el controlador de minipuerto admite la capacidad de emitir indicaciones de paquetes de reactivación, debe notificar esta capacidad cuando NDIS llama a la función MiniportInitializeEx del controlador. Para obtener más información, vea Reporting Wake Reason Status Indication Capabilities.

    Nota El controlador de minipuerto no tiene que notificar su capacidad de emitir indicaciones de estado del motivo de reactivación NDIS para eventos que no están relacionados con la recepción de un paquete WOL.

  • Cuando el controlador de minipuerto emite una indicación de paquete de reactivación para un paquete WOL, debe incluir el paquete que provocó el evento de reactivación. Para obtener más información, consulte Emisión de indicaciones de estado del motivo de reactivación de NDIS.

  • Si el adaptador de red generó una señal de reactivación, el controlador de minipuerto debe emitir una indicación de estado NDIS_STATUS_PM_WAKE_REASON . El controlador lo hace mientras controla la solicitud de conjunto de OID de OID_PNP_SET_POWER para la transición a un estado de energía completa.

  • El controlador de minipuerto debe emitir una indicación de estado NDIS_STATUS_PM_WAKE_REASON antes de emitir una indicación de estado relacionada con el evento de reactivación. Por ejemplo, si el evento de reactivación se debe a un cambio en el estado de conectividad multimedia, el controlador de miniporte debe emitir una indicación de estado de NDIS_STATUS_LINK_STATE después de haber emitido la indicación de estado NDIS_STATUS_PM_WAKE_REASON .

  • El controlador de minipuerto debe activar una indicación de estado NDIS_STATUS_PM_WAKE_REASON solo para los eventos de administración de energía que se habilitaron anteriormente a través de una solicitud de conjunto de OID de OID_PM_PARAMETERS.

  • El controlador de minipuerto debe emitir una indicación de estado de NDIS_STATUS_PM_WAKE_REASON solo para los eventos de reactivación generados por el adaptador de red subyacente.