Partager via


structure NET_WAKE_SOURCE_BITMAP_PARAMETERS (netwakesource.h)

La structure NET_WAKE_SOURCE_BITMAP_PARAMETERS contient des paramètres pour une source de veille de modèle bitmap WoL (Wake-on-LAN).

Syntaxe

typedef struct _NET_WAKE_SOURCE_BITMAP_PARAMETERS {
  ULONG       Size;
  ULONG       Id;
  UCHAR const *Pattern;
  SIZE_T      PatternSize;
  UCHAR const *Mask;
  SIZE_T      MaskSize;
} NET_WAKE_SOURCE_BITMAP_PARAMETERS;

Membres

Size

Taille de cette structure, en octets.

Id

Identificateur de cette source de mise en éveil.

Pattern

Séquence d’octets qui contient un modèle par rapport auquel comparer des octets dans un paquet entrant.

PatternSize

Taille du modèle bitmap, en octets.

Mask

Masque qui spécifie les octets dans les paquets entrants qui doivent être mis en correspondance avec le modèle bitmap. Chaque bit dans le masque de bits correspond à un octet dans le modèle. Si un bit est égal à zéro, l’octet correspondant dans le paquet entrant ne doit pas être mis en correspondance de modèle. Si le bit est un, la carte réseau compare l’octet dans le paquet entrant avec l’octet spécifié dans le modèle.

MaskSize

Taille du masque, en octets.

Remarques

Appelez NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT pour initialiser cette structure et remplir son champ Taille. Après avoir appelé NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT, appelez NetWakeSourceGetBitmapParameters pour renseigner les autres membres de la structure.

Un pilote de couche supérieure peut spécifier un modèle WOL générique avec le membre Pattern. Un modèle bitmap est spécifié sous la forme d’une séquence d’octets et d’une bitmap de masque, spécifiée dans le membre Mask. Chaque bit du masque correspond à un octet dans le modèle et spécifie si l’octet correspondant dans le paquet entrant doit être mis en correspondance avec l’octet correspondant dans le modèle. Si tous les octets comparés par la correspondance de la carte réseau correspondent, le paquet est une correspondance et la carte réseau doit générer un événement de mise en éveil.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 2004
version minimale de UMDF 2.33
d’en-tête netwakesource.h (include netadaptercx.h)

Voir aussi

Configuration des de gestion de l’alimentation

NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT

NetWakeSourceGetBitmapParameters