Partager via


OID_PNP_ENABLE_WAKE_UP

En tant qu’ensemble, l’OID OID_PNP_ENABLE_WAKE_UP spécifie les fonctionnalités de mise en éveil qu’un pilote miniport doit activer dans une carte réseau.

En tant que requête, OID_PNP_ENABLE_WAKE_UP obtient les fonctionnalités de mise en éveil actuelles activées pour une carte réseau.

Le membre InformationBuffer de la structure NDIS_OID_REQUEST est un masque de bits d’indicateurs qui peut être utilisé pour activer une combinaison d’événements de mise en éveil :

NDIS_PNP_WAKE_UP_MAGIC_PACKET
Lorsqu’il est défini, spécifie que le pilote miniport doit permettre à une carte réseau de signaler un événement de mise en éveil à la réception d’un paquet magique. (Un paquet magique est un paquet qui contient 16 copies contiguës de l’adresse Ethernet de la carte réseau de réception.) Lorsqu’il est désactivé, spécifie que le pilote miniport doit désactiver la carte réseau pour signaler un tel événement de mise en éveil.

NDIS_PNP_WAKE_UP_PATTERN_MATCH
Lorsqu’il est défini, spécifie que le pilote miniport doit permettre à une carte réseau de signaler un événement de mise en éveil à la réception d’un paquet qui contient un modèle spécifié par le protocole avec OID_PNP_ADD_WAKE_UP_PATTERN. Lorsqu’il est désactivé, spécifie que le pilote miniport doit désactiver la carte réseau pour signaler un tel événement de mise en éveil.

NDIS_PNP_WAKE_UP_LINK_CHANGE
Réservé. NDIS ignore cet indicateur.

Un pilote de protocole utilise les fonctionnalités de mise en éveil de la carte réseau dans NDIS_BIND_PARAMETERS pour activer les fonctionnalités de mise en éveil de la carte réseau associées. Un pilote de protocole peut également interroger cet OID pour déterminer quelles fonctionnalités de mise en éveil sont activées pour une carte réseau.

NDIS n’active pas immédiatement les fonctionnalités de mise en éveil spécifiées par un pilote de protocole. Au lieu de cela, NDIS effectue le suivi des fonctionnalités de mise en éveil activées par le pilote de protocole et, juste avant la transition de la carte réseau vers un état de faible consommation, NDIS envoie une demande de définition de OID_PNP_ENABLE_WAKE_UP au pilote miniport pour activer les événements de mise en éveil appropriés.

Avant la transition de la carte réseau vers un état de faible consommation (c’est-à-dire avant que NDIS envoie au pilote miniport une demande de OID_PNP_SET_POWER ), NDIS envoie au pilote miniport une demande de OID_PNP_ENABLE_WAKE_UP pour activer les fonctionnalités de mise en éveil appropriées.

Le pilote miniport doit prendre les mesures appropriées en fonction du périphérique pour activer ou désactiver les événements de mise en éveil sur la carte réseau.

Le pilote miniport doit effacer les fonctionnalités de mise en éveil définies par NDIS avec OID_PNP_ENABLE_WAKE_UP lors de la reprise du système. Les fonctionnalités de mise en éveil ne doivent pas être conservées entre les CV. Si les fonctionnalités de mise en éveil sont activées, NDIS définit explicitement OID_PNP_ENABLE_WAKE_UP avant que le miniport passe à l’état de faible consommation.

Un pilote intermédiaire dans lequel le bord supérieur reçoit cette requête OID doit toujours propager la demande au pilote miniport sous-jacent en appelant la fonction NdisOidRequest ou NdisCoOidRequest .

Spécifications

Version

Pris en charge dans NDIS 6.0 et 6.1. Pour NDIS 6.20 et versions ultérieures, utilisez OID_PM_PARAMETERS à la place).

En-tête

Ntddndis.h (inclure Ndis.h)

Voir aussi

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NdisCoOidRequest

NdisOidRequest

OID_PM_PARAMETERS

OID_PNP_ADD_WAKE_UP_PATTERN