estructura NDIS_PM_PARAMETERS (ntddndis.h)
La estructura NDIS_PM_PARAMETERS especifica las funcionalidades de hardware de administración de energía actuales o nuevas que están habilitadas para un adaptador de red.
Sintaxis
typedef struct _NDIS_PM_PARAMETERS {
NDIS_OBJECT_HEADER Header;
ULONG EnabledWoLPacketPatterns;
ULONG EnabledProtocolOffloads;
ULONG WakeUpFlags;
ULONG MediaSpecificWakeUpEvents;
} NDIS_PM_PARAMETERS, *PNDIS_PM_PARAMETERS;
Miembros
Header
Tipo, revisión y tamaño de la estructura de NDIS_PM_PARAMETERS . Este miembro tiene el formato de estructura NDIS_OBJECT_HEADER .
El controlador de minipuerto debe establecer el miembro Type de Header en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_PM_PARAMETERS , el controlador debe establecer el miembro Revision de Header en el siguiente valor:
NDIS_PM_PARAMETERS_REVISION_2
Se han agregado varios cambios para NDIS 6.30.
Establezca el miembro Size en NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_2.
NDIS_PM_PARAMETERS_REVISION_1
Versión original de NDIS 6.20.
Establezca el miembro Size en NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_1.
EnabledWoLPacketPatterns
Valor de ULONG que contiene un OR bit a bit de marcas que corresponden a funcionalidades que el controlador de minipuerto notificó en el miembro SupportedWoLPacketPatterns de la estructura NDIS_PM_CAPABILITIES . NDIS usa estas marcas para habilitar los patrones wake-on-LAN (WOL) que usa un adaptador de red para reactivar el equipo local desde un estado de bajo consumo. Para obtener más información sobre los patrones WOL, consulte NDIS_PM_WOL_PATTERN.
Se usan las marcas siguientes:
NDIS_PM_WOL_BITMAP_PATTERN_ENABLED
Si se establece esta marca, el adaptador de red se habilita para generar un evento de reactivación cuando recibe un paquete que coincide con un patrón de mapa de bits configurado.
NDIS_PM_WOL_MAGIC_PACKET_ENABLED
Si se establece esta marca, el adaptador de red se habilita para generar un evento de reactivación cuando recibe un paquete mágico WOL. Un paquete mágico contiene dentro de su carga una cadena de seis bytes con un valor de 0xFF, seguido inmediatamente de 16 copias contiguas de la dirección de control de acceso multimedia (MAC) del adaptador de red receptor.
NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_ENABLED
Si se establece esta marca, el adaptador de red se habilita para generar un evento de reactivación cuando recibe un mensaje de identificador de solicitud EAPOL.
NDIS_PM_WOL_IPV4_TCP_SYN_ENABLED
Si se establece esta marca, el adaptador de red se habilita para generar un evento de reactivación cuando recibe un paquete TCP SYN IPv4. Los hosts remotos envían paquetes TCP SYN para iniciar una conexión TCP al equipo local.
NDIS_PM_WOL_IPV6_TCP_SYN_ENABLED
Si se establece esta marca, el adaptador de red se habilita para generar un evento de reactivación cuando recibe un paquete TCP SYN IPv6.
NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED
Si se establece esta marca, el adaptador de red debe tratar como valores comodín cualquier valor de relleno cero o no especificado, los valores de las direcciones IPv4 y los puertos TCP/UDP en un patrón WOL. De este modo, el valor comodín coincide con cualquier dirección IPv4 y cualquier valor de puerto del paquete entrante en la ubicación especificada por el patrón WOL.
Si se establece esta marca, el adaptador de red está habilitado para generar un evento de reactivación si se cumplen las siguientes condiciones de coincidencia de patrones:
- Cualquier valor del paquete entrante en la ubicación especificada por el patrón WOL es una coincidencia, si el patrón WOL de esa ubicación contiene un valor comodín.
- Un valor del paquete entrante en la ubicación especificada por el patrón WOL es una coincidencia si el patrón WOL de esa ubicación contiene un valor distinto de cero que es igual al valor del paquete.
Nota
Los valores comodín habilitados por esta marca pueden incluir direcciones de origen y destino IPv4 no especificadas, así como puertos de origen y destino no especificados.
NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED
Si se establece esta marca, el adaptador de red debe tratar como valores comodín cualquier valor de relleno cero o no especificado, los valores de las direcciones IPv6 y los puertos TCP/UDP en un patrón WOL. De este modo, el valor comodín coincide con cualquier dirección IPv6 y cualquier valor de puerto del paquete entrante en la ubicación especificada por el patrón WOL.
Si se establece esta marca, el adaptador de red está habilitado para generar un evento de reactivación si se cumplen las siguientes condiciones de coincidencia de patrones:
- Cualquier valor del paquete entrante en la ubicación especificada por el patrón WOL es una coincidencia, si el patrón WOL de esa ubicación contiene un valor comodín.
- Un valor del paquete entrante en la ubicación especificada por el patrón WOL es una coincidencia si el patrón WOL de esa ubicación contiene un valor distinto de cero que es igual al valor del paquete.
Nota
Los valores comodín habilitados por esta marca pueden incluir direcciones de origen y destino IPv6 no especificadas, así como puertos de origen y destino no especificados.
EnabledProtocolOffloads
Valor de ULONG que contiene un OR bit a bit de marcas que corresponden a las funcionalidades que el controlador de miniportó notifica en el miembro SupportedProtocolOffloads de la estructura NDIS_PM_CAPABILITIES . NDIS usa estas marcas para habilitar las funcionalidades de descarga de protocolos de bajo consumo en un adaptador de red. Se usan las marcas siguientes:
NDIS_PM_PROTOCOL_OFFLOAD_ARP_ENABLED
Si se establece este bit, el controlador de sobreasignación solicitará al adaptador de red que habilite la funcionalidad de descarga del protocolo ARP. En cuanto se haya configurado la descarga de este protocolo mediante una solicitud establecida de OID_PM_ADD_PROTOCOL_OFFLOAD, el controlador debe permitir que el adaptador de red responda a los paquetes ARP IPv4 mientras se encuentra en un estado de bajo consumo.
NDIS_PM_PROTOCOL_OFFLOAD_NS_ENABLED
Si se establece este bit, el controlador de sobreasignación solicitará al adaptador de red que habilite la funcionalidad de descarga del protocolo de solicitud de vecino (NS) IPv6. En cuanto se haya configurado la descarga de este protocolo mediante una solicitud establecida de OID_PM_ADD_PROTOCOL_OFFLOAD, el controlador debe permitir que el adaptador de red responda a los paquetes NS mientras está en estado de baja potencia.
NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_ENABLED
Si se establece este bit, el controlador de sobreasignación solicitará al adaptador de red que habilite la funcionalidad de descarga del protocolo IEEE 802.11i Robust Security Network (RSN). En cuanto se haya configurado la descarga de este protocolo mediante una solicitud establecida de OID_PM_ADD_PROTOCOL_OFFLOAD, el controlador debe permitir que el adaptador de red responda a los paquetes de solicitudes de nueva clave de RSN mientras está en un estado de bajo consumo.
WakeUpFlags
Valor ULONG que contiene un or bit a bit de NDIS_PM_WAKE_ON_ marcas Xxx . NDIS usa estas marcas para habilitar las funcionalidades de reactivación en un adaptador de red. Este miembro usa las marcas siguientes:
NDIS_PM_WAKE_ON_LINK_CHANGE_ENABLED
Si se establece esta marca, el adaptador de red se habilita para generar un evento de reactivación cuando el estado del vínculo cambia de los medios desconectados a los medios conectados.
Para obtener más información sobre esta funcionalidad WOL, consulte Baja potencia en la desconexión de medios.
NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_ENABLED
Si se establece esta marca, el adaptador de red está habilitado para generar un evento de reactivación cuando el estado del vínculo cambia de los medios conectados a medios desconectados.
NDIS_PM_SELECTIVE_SUSPEND_ENABLED
Si se establece esta marca, el adaptador de red está habilitado para generar un evento de reactivación siempre que se produzca uno de los siguientes eventos:
- El adaptador de red recibe un paquete que coincide con un filtro de paquetes de recepción. El adaptador se configura con estos filtros a través de solicitudes de conjunto de OID de OID_GEN_CURRENT_PACKET_FILTER.
- El adaptador de red detecta otros eventos externos que requieren el procesamiento por parte de la pila de controladores de red, como cuando el estado del vínculo cambia a la desconexión multimedia o a los medios conectados.
Nota
La marca NDIS_PM_SELECTIVE_SUSPEND_ENABLED está disponible en NDIS 6.30 y versiones posteriores.
Si se establece esta marca, no se puede establecer ninguna otra marca de administración de energía en el miembro WakeUpFlags y el miembro EnabledWoLPacketPatterns debe establecerse en cero.
Si NDIS establece la marca NDIS_PM_SELECTIVE_SUSPEND_ENABLED , emite la solicitud de conjunto de OID de OID_PM_PARAMETERS directamente al controlador de minipuerto. Esto permite que NDIS omita el procesamiento mediante controladores de filtro en la pila de controladores de red.
Para obtener más información sobre la funcionalidad de administración selectiva de energía de suspensión, consulte Suspensión selectiva de NDIS.
MediaSpecificWakeUpEvents
Valor ULONG que contiene un OR bit a bit de marcas. Estas marcas especifican los eventos de reactivación específicos de medios que admite un adaptador de red.
A partir de NDIS 6.30, se definen las marcas siguientes:
NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_ENABLED
Si se establece esta marca, el adaptador de red 802.11 está habilitado para generar un evento de reactivación cuando detecta un identificador de conjunto de servicios (SSID) especificado a través de una descarga de red (NLO).
Para obtener más información sobre la descarga de lista de red, vea Descarga de lista de red Wi-Fi.
NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED
Si se establece esta marca, el adaptador de red 802.11 está habilitado para generar un evento de reactivación cuando se desasocia con el punto de acceso (AP).
NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED
Si se establece esta marca, el adaptador de red 802.11 se habilita para generar un evento de reactivación cuando encuentra un error durante el protocolo de enlace de la clave transitoria del grupo RSN IEEE 802.11i (GTK) con el AP.
NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED
Si se establece esta marca, el adaptador de red 802.11 se habilita para generar un evento de reactivación cuando recibe el primer fotograma del protocolo de enlace DE 4 vías ieee 802.11i RSN 4 con el AP. Este protocolo de enlace se realiza cuando el adaptador se autentica con el AP.
NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED
Si se establece esta marca, el adaptador de red de banda ancha móvil (MB) está habilitado para generar un evento de reactivación cuando su estado de registro en el servicio MB ha cambiado.
NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED
Si se establece esta marca, el adaptador de red MB está habilitado para generar un evento de reactivación cuando el servicio MB tiene que recibir una notificación sobre la recepción de un mensaje de Servicio de mensajes cortos (SMS). El adaptador genera este evento de reactivación después de la finalización de una solicitud de consulta emitida anteriormente OID_WWAN_SMS_READ o la llegada de un nuevo mensaje de clase 0 (flash/alert) del proveedor de red como una notificación de eventos.
NDIS_WWAN_WAKE_ON_USSD_RECEIVE_ENABLED
Si se establece esta marca, el adaptador de red MB está habilitado para generar un evento de reactivación cuando recibe un mensaje de datos de servicio complementarios no estructurados (USSD).
NDIS_WWAN_WAKE_ON_PACKET_STATE_ENABLED
Si se establece esta marca, el adaptador de red MB está habilitado para generar un evento de reactivación cuando cambia la disponibilidad de los datos de paquetes móviles. Esta marca es nueva en Windows 10.
NDIS_WWAN_WAKE_ON_UICC_CHANGE_ENABLED
Si se establece esta marca, el adaptador de red MB está habilitado para generar un evento de reactivación cuando se inserta, quita o entra en un estado de error la tarjeta UICC (SIM). Esta marca es nueva en Windows 10.
Comentarios
La estructura NDIS_PM_PARAMETERS especifica las funcionalidades de hardware de administración de energía habilitadas para el OID de OID_PM_PARAMETERS . Cuando se consulta el OID_PM_PARAMETERS OID, esta estructura proporciona la configuración de administración de energía actual. Cuando se establece el OID_PM_PARAMETERS OID, esta estructura especifica una nueva configuración de administración de energía que debe usar el adaptador de red.
Un controlador sobreampleado no debe intentar habilitar las funcionalidades que no admite un adaptador de red. Para permitir que un controlador sobreacabe para determinar qué funcionalidad proporciona un adaptador de red, NDIS proporciona las funcionalidades en el miembro PowerManagementCapabilitiesEx de la estructura NDIS_BIND_PARAMETERS .
Nota
Los controladores NDIS 6.20 y versiones posteriores deben usar el miembro PowerManagementCapabilitiesEx de la estructura NDIS_BIND_PARAMETERS en lugar del miembro PowerManagementCapabilities .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite en NDIS 6.20 y versiones posteriores. |
| Encabezado | ntddndis.h (incluya Ntddndis.h) |