structure NDIS_PM_PARAMETERS (ntddndis.h)
La structure NDIS_PM_PARAMETERS spécifie les fonctionnalités matérielles actuelles ou nouvelles de gestion de l’alimentation 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 de l'd’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 Révision de -tête sur la valeur suivante :
NDIS_PM_PARAMETERS_REVISION_2
Ajout de différentes modifications pour NDIS 6.30.
Définissez le membre Size 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 une OU d’indicateurs qui correspondent aux fonctionnalités signalées par le pilote miniport dans les SupportedWoLPacketPatterns membre 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 réveiller l’ordinateur local à partir d’un état d’alimentation faible. 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 lancer 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 TCP SYN IPv6.
NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED
Si cet indicateur est défini, la carte réseau doit être traitée comme caractères génériques valeurs toutes les valeurs vides ou non spécifiées, valeurs 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 à n’importe quelle 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 vraies :
- Toute valeur du paquet entrant dans 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 dans 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 correspond à la valeur du paquet.
Note
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 être traitée comme caractères génériques valeurs zéro remplies ou non spécifiées, valeurs 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 dans 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 vraies :
- Toute valeur du paquet entrant dans 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 dans 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 correspond à la valeur du paquet.
Note
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 de ULONG qui contient une ou d’indicateurs qui correspondent aux fonctionnalités signalées par le pilote miniport dans les SupportedProtocolOffloads membre de la structure NDIS_PM_CAPABILITIES. NDIS utilise ces indicateurs pour activer les fonctionnalités de déchargement de protocole à faible 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 surlysant demande la carte réseau pour 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 pendant qu’il est dans un état de faible alimentation.
NDIS_PM_PROTOCOL_OFFLOAD_NS_ENABLED
Si ce bit est défini, le pilote surchargé demande la carte réseau pour activer la fonctionnalité de déchargement du protocole NS (IPv6 Neighbor Request). 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 pendant qu’elle est dans un état à faible alimentation.
NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_ENABLED
Si ce bit est défini, le pilote overlying demande la carte réseau pour activer la fonctionnalité de déchargement du protocole IEEE 802.11i Robust Security Network (RSN). Dès que ce déchargement de protocole a été configuré par une requête 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 pendant qu’il est dans un état de faible alimentation.
WakeUpFlags
Valeur ULONG qui contient une or au niveau du bit de NDIS_PM_WAKE_ON_ indicateurs de Xxx. 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 du média déconnecté au 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 du média connecté au 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 qu’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 par le biais de requêtes 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 de pilotes de mise en réseau, par exemple lorsque l’état du lien passe à une déconnexion multimédia ou à un média connecté.
Note
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 les EnabledWoLPacketPatterns membre doivent être définis 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 par les pilotes de filtre dans la pile des pilotes de mise en réseau.
Pour plus d’informations sur la fonctionnalité de gestion sélective de l’alimentation de suspension, consultez de suspension sélective NDIS.
MediaSpecificWakeUpEvents
Valeur de ULONG qui contient une OU d’indicateurs au niveau du bit. Ces indicateurs spécifient les événements de mise en éveil spécifiques aux médias 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’il détecte un identificateur de jeu de services (SSID) spécifié via un déchargement réseau (NLO).
Pour plus d’informations sur le NLO, consultez Wi-Fi network list offload.
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 dissocie 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 erreur lors de l’établissement d’une liaison de clé temporaire du groupe RSN IEEE 802.11i (GTK) 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 image de l’établissement d’une liaison IEEE 802.11i RSN 4 way avec l’AP. Cette négociation est effectuée lorsque l’adaptateur s’authentifie auprès de l’API.
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 (Non structuré Supplémentaire 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 la carte UICC (SIM) est insérée, supprimée ou entre 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 la OID_PM_PARAMETERS OID est interrogée, cette structure fournit la configuration actuelle de la 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 overlying ne doit pas essayer d’activer les fonctionnalités qu’une carte réseau ne prend pas en charge. Pour permettre à un pilote overlying de déterminer les fonctionnalités qu’une carte réseau fournit, NDIS fournit les fonctionnalités de l'PowerManagementCapabilitiesEx membre de la structure NDIS_BIND_PARAMETERS.
Note
Les pilotes NDIS 6.20 et ultérieurs doivent utiliser le membre PowerManagementCapabilitiesEx de la structure NDIS_BIND_PARAMETERS au lieu du membre PowerManagementCapabilities.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge dans NDIS 6.20 et versions ultérieures. |
| d’en-tête | ntddndis.h (include Ntddndis.h) |