NDIS_PM_PARAMETERS structure (ntddndis.h)
La structure NDIS_PM_PARAMETERS spécifie les fonctionnalités matérielles de gestion de l’alimentation actuelles ou nouvelles activées pour une carte réseau.
Syntaxe
typedef struct _NDIS_PM_PARAMETERS {
NDIS_OBJECT_HEADER Header;
ULONG EnabledWoLPacketPatterns;
ULONG EnabledProtocolOffloads;
ULONG WakeUpFlags;
ULONG MediaSpecificWakeUpEvents;
} NDIS_PM_PARAMETERS, *PNDIS_PM_PARAMETERS;
Membres
Header
Type, révision et taille de la structure NDIS_PM_PARAMETERS . Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .
Le pilote miniport doit définir le membre Type de l’en-tête sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_PM_PARAMETERS , le pilote doit définir le membre Revision de Header sur la valeur suivante :
NDIS_PM_PARAMETERS_REVISION_2
Ajout de diverses modifications pour NDIS 6.30.
Définissez le membre Taille sur NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_2.
NDIS_PM_PARAMETERS_REVISION_1
Version d’origine de NDIS 6.20.
Définissez le membre Taille sur NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_1.
EnabledWoLPacketPatterns
Valeur ULONG qui contient un OR au niveau du bit d’indicateurs qui correspondent aux fonctionnalités signalées par le pilote miniport dans le membre SupportedWoLPacketPatterns de la structure NDIS_PM_CAPABILITIES . NDIS utilise ces indicateurs pour activer les modèles wol (wake-on-LAN) qu’une carte réseau utilise pour sortir l’ordinateur local d’un état de faible consommation. Pour plus d’informations sur les modèles WOL, consultez NDIS_PM_WOL_PATTERN.
Les indicateurs suivants sont utilisés :
NDIS_PM_WOL_BITMAP_PATTERN_ENABLED
Si cet indicateur est défini, la carte réseau est activée pour générer un événement de mise en éveil lorsqu’elle reçoit un paquet qui correspond à un modèle bitmap configuré.
NDIS_PM_WOL_MAGIC_PACKET_ENABLED
Si cet indicateur est défini, la carte réseau est activée pour générer un événement de mise en éveil lorsqu’elle reçoit un paquet magique WOL. Un paquet magique contient dans sa charge utile une chaîne de six octets avec une valeur de 0xFF, suivie immédiatement de 16 copies contiguës de l’adresse MAC (Media Access Control) de la carte réseau de réception.
NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_ENABLED
Si cet indicateur est défini, la carte réseau est activée pour générer un événement de mise en éveil lorsqu’elle reçoit un message d’identificateur de requête EAPOL.
NDIS_PM_WOL_IPV4_TCP_SYN_ENABLED
Si cet indicateur est défini, la carte réseau est activée pour générer un événement de mise en éveil lorsqu’elle reçoit un paquet TCP SYN IPv4. Les hôtes distants envoient des paquets TCP SYN pour initier une connexion TCP à l’ordinateur local.
NDIS_PM_WOL_IPV6_TCP_SYN_ENABLED
Si cet indicateur est défini, la carte réseau est activée pour générer un événement de mise en éveil lorsqu’elle reçoit un paquet SYN TCP IPv6.
NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED
Si cet indicateur est défini, la carte réseau doit traiter comme des valeurs génériques toutes les valeurs vides ou non spécifiées pour les adresses IPv4 et les ports TCP/UDP dans un modèle WOL. De cette façon, la valeur générique correspond à n’importe quelle adresse IPv4 et à toute valeur de port du paquet entrant à l’emplacement spécifié par le modèle WOL.
Si cet indicateur est défini, la carte réseau est activée pour générer un événement de mise en éveil si les conditions de correspondance de modèle suivantes sont remplies :
- Toute valeur du paquet entrant à l’emplacement spécifié par le modèle WOL est une correspondance, si le modèle WOL pour cet emplacement contient une valeur générique.
- Une valeur du paquet entrant à l’emplacement spécifié par le modèle WOL est une correspondance si le modèle WOL pour cet emplacement contient une valeur différente de zéro qui est égale à la valeur du paquet.
Notes
Les valeurs génériques activées par cet indicateur peuvent inclure des adresses source et de destination IPv4 non spécifiées, ainsi que des ports source et de destination non spécifiés.
NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED
Si cet indicateur est défini, la carte réseau doit traiter comme des valeurs génériques toutes les valeurs vides ou non spécifiées pour les adresses IPv6 et les ports TCP/UDP dans un modèle WOL. De cette façon, la valeur générique correspond à n’importe quelle adresse IPv6 et à toute valeur de port du paquet entrant à l’emplacement spécifié par le modèle WOL.
Si cet indicateur est défini, la carte réseau est activée pour générer un événement de mise en éveil si les conditions de correspondance de modèle suivantes sont remplies :
- Toute valeur du paquet entrant à l’emplacement spécifié par le modèle WOL est une correspondance, si le modèle WOL pour cet emplacement contient une valeur générique.
- Une valeur du paquet entrant à l’emplacement spécifié par le modèle WOL est une correspondance si le modèle WOL pour cet emplacement contient une valeur différente de zéro qui est égale à la valeur du paquet.
Notes
Les valeurs génériques activées par cet indicateur peuvent inclure des adresses source et de destination IPv6 non spécifiées, ainsi que des ports source et de destination non spécifiés.
EnabledProtocolOffloads
Valeur ULONG qui contient un OR au niveau du bit d’indicateurs qui correspondent aux fonctionnalités signalées par le pilote miniport dans le membre SupportedProtocolOffloads de la structure NDIS_PM_CAPABILITIES . NDIS utilise ces indicateurs pour activer les fonctionnalités de déchargement du protocole basse alimentation sur une carte réseau. Les indicateurs suivants sont utilisés :
NDIS_PM_PROTOCOL_OFFLOAD_ARP_ENABLED
Si ce bit est défini, le pilote d’overlying demande à la carte réseau d’activer la fonctionnalité de déchargement du protocole ARP. Dès que ce déchargement de protocole a été configuré par une demande définie de OID_PM_ADD_PROTOCOL_OFFLOAD, le pilote doit permettre à la carte réseau de répondre aux paquets ARP IPv4 lorsqu’elle est dans un état de faible consommation.
NDIS_PM_PROTOCOL_OFFLOAD_NS_ENABLED
Si ce bit est défini, le pilote de surélément demande à la carte réseau d’activer la fonctionnalité de déchargement du protocole NS (IPv6 Neighbor Solicitation). Dès que ce déchargement de protocole a été configuré par une demande définie de OID_PM_ADD_PROTOCOL_OFFLOAD, le pilote doit permettre à la carte réseau de répondre aux paquets NS lorsqu’elle est dans un état de faible consommation.
NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_ENABLED
Si ce bit est défini, le pilote de surélément demande à la carte réseau d’activer la fonctionnalité de déchargement du protocole RSN (Robust Security Network) IEEE 802.11i. Dès que ce déchargement de protocole a été configuré par une demande définie de OID_PM_ADD_PROTOCOL_OFFLOAD, le pilote doit permettre à la carte réseau de répondre aux paquets de demandes de nouvelle clé RSN lorsqu’elle est dans un état de faible consommation.
WakeUpFlags
Valeur ULONG qui contient un OR au niveau du bit de NDIS_PM_WAKE_ON_ xxx indicateurs. NDIS utilise ces indicateurs pour activer les fonctionnalités de mise en éveil sur une carte réseau. Ce membre utilise les indicateurs suivants :
NDIS_PM_WAKE_ON_LINK_CHANGE_ENABLED
Si cet indicateur est défini, la carte réseau est activée pour générer un événement de mise en éveil lorsque l’état du lien passe d’un média déconnecté à un média connecté.
Pour plus d’informations sur cette fonctionnalité WOL, consultez Low Power on Media Disconnect.
NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_ENABLED
Si cet indicateur est défini, la carte réseau est activée pour générer un événement de mise en éveil lorsque l’état du lien passe d’un média connecté à un média déconnecté.
NDIS_PM_SELECTIVE_SUSPEND_ENABLED
Si cet indicateur est défini, la carte réseau est activée pour générer un événement de mise en éveil chaque fois que l’un des événements suivants se produit :
- La carte réseau reçoit un paquet qui correspond à un filtre de paquets de réception. L’adaptateur est configuré avec ces filtres via les demandes de jeu d’OID de OID_GEN_CURRENT_PACKET_FILTER.
- La carte réseau détecte d’autres événements externes qui nécessitent un traitement par la pile des pilotes de mise en réseau, par exemple lorsque l’état de la liaison passe à la déconnexion de média ou au média connecté.
Notes
L’indicateur NDIS_PM_SELECTIVE_SUSPEND_ENABLED est disponible dans NDIS 6.30 et versions ultérieures.
Si cet indicateur est défini, aucun autre indicateur de gestion de l’alimentation ne peut être défini dans le membre WakeUpFlags et le membre EnabledWoLPacketPatterns doit être défini sur zéro.
Si NDIS définit l’indicateur NDIS_PM_SELECTIVE_SUSPEND_ENABLED , il émet la demande de jeu d’OID de OID_PM_PARAMETERS directement au pilote miniport. Cela permet à NDIS de contourner le traitement en filtrant les pilotes dans la pile des pilotes de mise en réseau.
Pour plus d’informations sur la fonctionnalité de gestion de l’alimentation de suspension sélective, consultez Suspension sélective NDIS.
MediaSpecificWakeUpEvents
Valeur ULONG qui contient un OR au niveau du bit d’indicateurs. Ces indicateurs spécifient les événements de mise en éveil spécifiques au média qu’une carte réseau prend en charge.
À compter de NDIS 6.30, les indicateurs suivants sont définis :
NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_ENABLED
Si cet indicateur est défini, la carte réseau 802.11 est activée pour générer un événement de mise en éveil lorsqu’elle détecte un identificateur de jeu de services (SSID) qui a été spécifié via un déchargement réseau (NLO).
Pour plus d’informations sur le NLO, consultez Déchargement de liste de réseaux Wi-Fi.
NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED
Si cet indicateur est défini, la carte réseau 802.11 est activée pour générer un événement de mise en éveil lorsqu’elle se dissocie avec le point d’accès (AP).
NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED
Si cet indicateur est défini, la carte réseau 802.11 est activée pour générer un événement de mise en éveil lorsqu’elle rencontre une erreur lors de l’établissement d’une liaison de clé temporaire de groupe RSN (GTK) IEEE 802.11i avec l’AP.
NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED
Si cet indicateur est défini, la carte réseau 802.11 est activée pour générer un événement de mise en éveil lorsqu’elle reçoit la première trame de l’établissement d’une liaison 4 voies IEEE 802.11i RSN avec l’AP. Cette négociation est effectuée lorsque l’adaptateur s’authentifie auprès de l’AP.
NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED
Si cet indicateur est défini, la carte réseau haut débit mobile (Mo) est activée pour générer un événement de mise en éveil lorsque son état d’inscription au service Mo a changé.
NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED
Si cet indicateur est défini, la carte réseau Mo est activée pour générer un événement de mise en éveil lorsque le service Mo doit être averti de la réception d’un message SMS (Short Message Service). L’adaptateur génère cet événement de mise en éveil après l’achèvement d’une demande de requête OID_WWAN_SMS_READ précédemment émise, ou l’arrivée d’un nouveau message de classe 0 (flash/alerte) du fournisseur réseau en tant que notification d’événement.
NDIS_WWAN_WAKE_ON_USSD_RECEIVE_ENABLED
Si cet indicateur est défini, la carte réseau Mo est activée pour générer un événement de mise en éveil lorsqu’elle reçoit un message USSD (Unstructured Supplementary Service Data).
NDIS_WWAN_WAKE_ON_PACKET_STATE_ENABLED
Si cet indicateur est défini, la carte réseau Mo est activée pour générer un événement de mise en éveil lorsque la disponibilité des données de paquets cellulaires change. Cet indicateur est nouveau dans Windows 10.
NDIS_WWAN_WAKE_ON_UICC_CHANGE_ENABLED
Si cet indicateur est défini, la carte réseau Mo est activée pour générer un événement de mise en éveil lorsque le carte UICC (SIM) est inséré, supprimé ou entre dans un état d’erreur. Cet indicateur est nouveau dans Windows 10.
Remarques
La structure NDIS_PM_PARAMETERS spécifie les fonctionnalités matérielles de gestion de l’alimentation activées pour l’OID OID_PM_PARAMETERS . Lorsque le OID_PM_PARAMETERS OID est interrogé, cette structure fournit la configuration actuelle de gestion de l’alimentation. Lorsque le OID_PM_PARAMETERS OID est défini, cette structure spécifie une nouvelle configuration de gestion de l’alimentation que la carte réseau doit utiliser.
Un pilote trop important ne doit pas essayer d’activer les fonctionnalités qu’une carte réseau ne prend pas en charge. Pour permettre à un pilote en surploie de déterminer les fonctionnalités d’une carte réseau, NDIS fournit les fonctionnalités du membre PowerManagementCapabilitiesEx de la structure NDIS_BIND_PARAMETERS .
Notes
Les pilotes NDIS 6.20 et versions ultérieures doivent utiliser le membre PowerManagementCapabilitiesEx de la structure NDIS_BIND_PARAMETERS au lieu du membre PowerManagementCapabilities .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge dans NDIS 6.20 et versions ultérieures. |
| En-tête | ntddndis.h (inclure Ntddndis.h) |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour