NET_WAKE_SOURCE_BITMAP_PARAMETERS 结构 (netwakesource.h)
NET_WAKE_SOURCE_BITMAP_PARAMETERS 结构包含 LAN 唤醒 (WoL) 位图模式唤醒源的参数。
语法
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;
成员
Size
此结构的大小(以字节为单位)。
Id
此唤醒源的标识符。
Pattern
包含模式的字节序列,用于比较传入数据包中的字节数。
PatternSize
位图模式的大小(以字节为单位)。
Mask
一个掩码,指定传入数据包中的哪些字节应与位图模式匹配。 位掩码中的每个位对应于模式中的一个字节。 如果位为零,则传入数据包中的相应字节不应与模式匹配。 如果位为 1,则网络适配器会将传入数据包中的字节与模式中指定的字节进行比较。
MaskSize
掩码的大小(以字节为单位)。
注解
调用 NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT 初始化此结构并填充其 Size 字段。 调用 NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT后,调用 NetWakeSourceGetBitmapParameters 以填充结构的其他成员。
上层驱动程序可以使用 Pattern 成员指定泛型 WOL 模式 。 位图模式指定为字节序列和掩码位图,在 Mask 成员中指定。 掩码中的每个位对应于模式中的一个字节,并指定是否应将传入数据包中的相应字节与模式中的相应字节匹配。 如果网络适配器比较的所有字节都匹配,则数据包是匹配的,并且网络适配器应生成唤醒事件。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 版本 2004 |
最低 UMDF 版本 | 2.33 |
标头 | netwakesource.h (包括 netadaptercx.h) |