NET_WAKE_SOURCE_BITMAP_PARAMETERS structure (netwakesource.h)

  • Article

La structure NET_WAKE_SOURCE_BITMAP_PARAMETERS contient des paramètres pour une source d’éveil du modèle bitmap wake-on-LAN (WoL).

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 sortie de veille.

Pattern

Séquence d’octets qui contient un modèle par rapport auquel comparer les octets d’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 du 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 avec le 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és 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 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 2004
En-tête netwakesource.h (incluez netadaptercx.h)

Voir aussi

Configuration de la gestion de l’alimentation

NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT

NetWakeSourceGetBitmapParameters