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