Funcionalidades de indicación de estado del motivo de reactivación de informes

A partir de NDIS 6.30, el controlador de minipuerto debe notificar si puede emitir una indicación de estado del motivo de reactivación NDIS (NDIS_STATUS_PM_WAKE_REASON) para notificar los eventos de reactivación causados por una de las siguientes acciones:

• El adaptador de red recibió un paquete que coincidía con un patrón wake-on-LAN (WOL). Esto incluye la recepción de un paquete que coincide con un filtro de recepción especificado a través de una solicitud de conjunto de identificador de objeto (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.

• El adaptador de red detectó un evento específico de medios, 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).

• El adaptador de red detectó otro evento habilitado que no es específico de un patrón WOL o un tipo de medio (evento independiente del medio). Por ejemplo, el controlador de minipuerto emite la indicación de estado NDIS_STATUS_PM_WAKE_REASON si habilitó el adaptador de red para detectar la conexión o desconexión de medios.

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).

Cuando NDIS llama a la función MiniportInitializeEx del controlador, el controlador de minipuerto notifica sus funcionalidades de indicación de estado del motivo de reactivación siguiendo estos pasos:

1. El controlador de minipuerto inicializa una estructura de NDIS_PM_CAPABILITIES con las funcionalidades de administración de energía del hardware subyacente.

   Para habilitar la compatibilidad con las indicaciones de estado del motivo de reactivación, el controlador de minipuerto debe establecer los miembros de la estructura NDIS_PM_CAPABILITIES de la siguiente manera:

   • El controlador de minipuerto debe especificar NDIS_PM_CAPABILITIES_REVISION_2 y NDIS_SIZEOF_NDIS_PM_CAPABILITIES_REVISION_2 para la revisión y longitud de la estructura NDIS_PM_CAPABILITIES dentro del miembro Header de la estructura.

   • Si el adaptador de red puede almacenar el paquete recibido que provocó un evento de reactivación del sistema, el controlador de miniporte establece la marca NDIS_PM_WAKE_PACKET_INDICATION_SUPPORTED dentro del miembro Flags de esta estructura.

     Si se establece esta marca, el adaptador de red debe poder guardar el paquete recibido que provocó que el adaptador generara un evento de reactivación. Además, el controlador de minipuerto debe ser capaz de hacer lo siguiente con este paquete después de que el adaptador de red pase a un estado de energía completa:

     • El controlador de minipuerto debe poder indicar el paquete llamando a NdisMIndicateReceiveNetBufferLists.

     • El controlador de minipuerto debe poder emitir una indicación de estado NDIS_STATUS_PM_WAKE_REASON y debe pasar el paquete con indicación.

   • El controlador de minipuerto establece el miembro MaxWoLPacketSaveBuffer en el tamaño máximo, en unidades de bytes, del búfer que contiene el paquete WOL que provocó un evento de reactivación del sistema.

     El valor del miembro MaxWoLPacketSaveBuffer debe ser menor o igual que el tamaño, en bytes, del encabezado de unidad de transmisión máxima (MTU) y control de acceso multimedia (MAC) para el medio de red. El controlador notifica el tamaño de MTU a través de solicitudes de consulta de OID de OID_GEN_MAXIMUM_FRAME_SIZE.

   • El controlador de minipuerto establece SupportedWakeUpEvents en los eventos de reactivación independientes de medios que admite el adaptador de red, como la generación de un evento de reactivación cuando el adaptador se conecta a la interfaz de red.

   • El controlador de minipuerto establece MediaSpecificWakeUpEvents en los eventos de reactivación específicos de medios que admite el adaptador de red. Estos eventos incluyen la generación de un evento de reactivación cuando el adaptador 802.11 se desasocia con el AP.

2. El controlador de minipuerto inicializa una estructura de NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES y establece el miembroPowerManagementCapabilitiesEx en la dirección de la estructura de NDIS_PM_CAPABILITIES inicializada.

3. El controlador de minipuerto llama a la función NdisMSetMiniportAttributes para registrar sus capacidades de administración de energía. Cuando el controlador de minipuerto llama a esta función, establece el parámetro MiniportAttributes en la dirección de la estructura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES .

El método que usan los controladores de minipuerto para informar de las funcionalidades de indicación de estado del motivo de reactivación se basa en el método NDIS 6.20 para notificar las funcionalidades de administración de energía. Para obtener más información sobre este método, vea Reporting Power Management Capabilities.

Para obtener más información sobre el proceso de inicialización del adaptador, consulte Inicialización de un adaptador de minipuerto.

Para obtener más información sobre cómo notificar las funcionalidades de administración de energía, consulte Reporting Power Management Capabilities.