NET_WAKE_SOURCE_BITMAP_PARAMETERS structure (netwakesource.h)
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 |
| Version UMDF minimale | 2,33 |
| En-tête | netwakesource.h (incluez netadaptercx.h) |
Voir aussi
Configuration de la gestion de l’alimentation