structure NDIS_PM_WAKE_PACKET (ntddndis.h)

Article
02/07/2025

La structure NDIS_PM_WAKE_PACKET décrit un paquet réseau (appelé paquet de mise en éveil) qui a provoqué la génération d’un événement de mise en éveil.

Syntaxe

typedef struct _NDIS_PM_WAKE_PACKET {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  ULONG                  PatternId;
  NDIS_PM_COUNTED_STRING PatternFriendlyName;
  ULONG                  OriginalPacketSize;
  ULONG                  SavedPacketSize;
  ULONG                  SavedPacketOffset;
} NDIS_PM_WAKE_PACKET, *PNDIS_PM_WAKE_PACKET;

Membres

Header

Type, révision et taille de la structure NDIS_PM_WAKE_PACKET. 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_WAKE_PACKET, le pilote doit définir le membre révision du d’en-tête sur la valeur suivante :

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

Version d’origine pour NDIS 6.30 et versions ultérieures.

Définissez le membre Size sur NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1.

Flags

Valeur de ULONG qui contient une OU d’indicateurs au niveau du bit. Ce membre est réservé à NDIS.

PatternId

Valeur ULONG qui spécifie l’identificateur du modèle WAKE-on-LAN (WOL) qui correspond au paquet de mise en éveil. Cet identificateur est spécifié par le PatternId membre de la structure NDIS_PM_WOL_PATTERN qui est passée au pilote pendant une demande de jeu d’OID de OID_PM_ADD_WOL_PATTERN.

PatternFriendlyName

Valeur NDIS_PM_COUNTED_STRING qui contient la description conviviale du modèle de veille spécifié par le membre PatternId. Cette valeur est spécifiée par le membre FriendlyName de la structure NDIS_PM_WOL_PATTERN transmise au pilote lors d’une requête OID de OID_PM_ADD_WOL_PATTERN.

Remarque Le pilote miniport n’a pas besoin d’initialiser ce membre. NDIS définit le membre PatternFriendlyName à la valeur correcte avant de passer la structure NDIS_PM_WAKE_PACKET aux pilotes trop volumineux.

OriginalPacketSize

Valeur ULONG qui spécifie la longueur d’origine, en unités d’octets, du paquet de veille.

SavedPacketSize

Valeur ULONG qui spécifie la longueur, en unités d’octets, des données de paquets de veille qui suivent cette structure.

Remarque La valeur de ce membre doit au moins min(wake packet size, 128) octets.

SavedPacketOffset

Valeur ULONG qui spécifie le décalage, en unités d’octets, aux données de paquets de mise en éveil qui suivent cette structure. Le décalage est mesuré du début de la structure NDIS_PM_WAKE_PACKET au début d’une mémoire tampon qui contient le paquet de mise en éveil.

Remarque Le décalage vers le paquet de veille enregistré doit être aligné sur une limite 64 bits.

Remarques

La structure NDIS_PM_WAKE_PACKET est utilisée dans l’indication d’état NDIS_STATUS_PM_WAKE_REASON. Pour plus d’informations sur la façon d’émettre cette indication d’état, consultez Indications d’état de la raison du réveil NDIS.