structure NDIS_PM_WAKE_PACKET (ntddndis.h)

Article
02/26/2024

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

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 l’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 Revision de Header 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 ULONG qui contient un OR au niveau du bit d’indicateurs. 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 veille. Cet identificateur est spécifié par le membre PatternId de la structure NDIS_PM_WOL_PATTERN passée au pilote lors d’une demande de jeu 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 passée au pilote lors d’une requête OID de OID_PM_ADD_WOL_PATTERN.

Note Le pilote miniport n’a pas besoin d’initialiser ce membre. NDIS définit le membre PatternFriendlyName sur la valeur correcte avant qu’il ne passe la structure NDIS_PM_WAKE_PACKET aux pilotes qui se superposent.

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 paquet de veille qui suivent cette structure.

Note La valeur de ce membre doit être d’au moins min(wake packet size, 128) octets.

SavedPacketOffset

Valeur ULONG qui spécifie le décalage, en unités d’octets, des données de paquet de veille 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 veille.

Note 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 status NDIS_STATUS_PM_WAKE_REASON. Pour plus d’informations sur la façon d’émettre cette indication status, consultez Émission des indications d’état du motif de veille NDIS.