Share via

Fonctionnalités d’indication de l’état du motif de veille de rapport

  • Article

À compter de NDIS 6.30, le pilote miniport doit indiquer s’il peut émettre une raison de veille NDIS status indication (NDIS_STATUS_PM_WAKE_REASON) pour signaler les événements de réveil causés par l’un des éléments suivants :

  • La carte réseau a reçu un paquet correspondant à un modèle wol (wake-on-LAN). Cela inclut la réception d’un paquet qui correspond à un filtre de réception spécifié par le biais d’une demande de jeu d’identificateur d’objet (OID) de OID_GEN_CURRENT_PACKET_FILTER.

    Note Pour ce type de raison de veille status indication, la carte réseau doit être en mesure d’enregistrer le paquet reçu. Le pilote doit retourner le paquet reçu dans l’indication status.

  • La carte réseau a détecté un événement spécifique au média, tel qu’une dissociation d’un point d’accès 802.11 (AP) ou la réception d’un message SMS à haut débit mobile (Mo).

  • La carte réseau a détecté un autre événement activé qui n’est pas spécifique à un modèle WOL ou à un type de média (événement indépendant du média). Par exemple, le pilote miniport émet le NDIS_STATUS_PM_WAKE_REASON status’indication s’il a activé la carte réseau pour détecter la connexion ou la déconnexion multimédia.

Note La prise en charge de la raison du réveil NDIS status indications est facultative pour les pilotes miniports à haut débit mobile (Mo).

Lorsque NDIS appelle la fonction MiniportInitializeEx du pilote, le pilote miniport indique sa raison de réveil status fonctionnalités d’indication en procédant comme suit :

  1. Le pilote miniport initialise une structure NDIS_PM_CAPABILITIES avec les fonctionnalités de gestion de l’alimentation du matériel sous-jacent.

    Pour activer la prise en charge de la raison du réveil status indications, le pilote miniport doit définir les membres de la structure NDIS_PM_CAPABILITIES comme suit :

    • Le pilote miniport doit spécifier NDIS_PM_CAPABILITIES_REVISION_2 et NDIS_SIZEOF_NDIS_PM_CAPABILITIES_REVISION_2 pour la révision et la longueur de la structure NDIS_PM_CAPABILITIES dans le membre Header de la structure.

    • Si la carte réseau peut stocker le paquet reçu qui a provoqué un événement de mise en éveil du système, le pilote miniport définit l’indicateur NDIS_PM_WAKE_PACKET_INDICATION_SUPPORTED dans le membre Flags de cette structure.

      Si cet indicateur est défini, la carte réseau doit être en mesure d’enregistrer le paquet reçu qui a provoqué la génération d’un événement de mise en éveil. En outre, le pilote miniport doit être en mesure d’effectuer les opérations suivantes avec ce paquet après la transition de la carte réseau vers un état d’alimentation totale :

    • Le pilote miniport définit le membre MaxWoLPacketSaveBuffer sur la taille maximale, en unités d’octets, de la mémoire tampon qui contient le paquet WOL qui a provoqué un événement de mise en éveil du système.

      La valeur du membre MaxWoLPacketSaveBuffer doit être inférieure ou égale à la taille, en octets, de l’en-tête de l’unité de transmission maximale (MTU) et de l’en-tête mac (Media Access Control) pour le média réseau. Le pilote signale la taille MTU par le biais des requêtes OID de OID_GEN_MAXIMUM_FRAME_SIZE.

    • Le pilote miniport définit supportedWakeUpEvents sur les événements de mise en éveil indépendants du média que la carte réseau prend en charge, comme la génération d’un événement de mise en éveil lorsque la carte devient connectée à l’interface réseau.

    • Le pilote miniport définit MediaSpecificWakeUpEvents sur les événements de mise en éveil spécifiques au média pris en charge par la carte réseau. Ces événements incluent la génération d’un événement de mise en éveil lorsque l’adaptateur 802.11 devient dissocié du point d’accès.

  2. Le pilote miniport initialise une structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES et définit le membrePowerManagementCapabilitiesEx sur l’adresse de la structure NDIS_PM_CAPABILITIES initialisée.

  3. Le pilote miniport appelle la fonction NdisMSetMiniportAttributes pour inscrire ses fonctionnalités de gestion de l’alimentation. Lorsque le pilote miniport appelle cette fonction, il définit le paramètre MiniportAttributes sur l’adresse de la structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES .

La méthode utilisée par les pilotes miniport pour signaler la raison du réveil status fonctionnalités d’indication est basée sur la méthode NDIS 6.20 pour signaler les fonctionnalités de gestion de l’alimentation. Pour plus d’informations sur cette méthode, consultez Création de rapports sur les fonctionnalités de gestion de l’alimentation.

Pour plus d’informations sur le processus d’initialisation de l’adaptateur, consultez Initialisation d’un adaptateur Miniport.

Pour plus d’informations sur la façon de signaler les fonctionnalités de gestion de l’alimentation, consultez Création de rapports sur les fonctionnalités de gestion de l’alimentation.