NET_WAKE_SOURCE_BITMAP_PARAMETERS結構 (netwakesource.h)
NET_WAKE_SOURCE_BITMAP_PARAMETERS 結構包含網路喚醒 (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
遮罩,指定應該比對位圖模式的傳入封包中的位元組。 位掩碼中的每個位都會對應至模式中的位元元組。 如果位為零,則不應該比對傳入封包中的對應位元組。 如果位是其中一個,網路適配器會比較傳入封包中的位元組與模式中指定的位元組。
MaskSize
遮罩的大小,以位元組為單位。
備註
呼叫 NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT 初始化此結構,並填入其 [大小 ] 字段。 呼叫 NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT之後,請呼叫 NetWakeSourceGetBitmapParameters 以填入結構的其他成員。
上層驅動程式可以使用 Pattern 成員來指定泛型 WOL 模式 。 位圖模式會指定為位元組序列,以及 Mask 成員中指定的遮罩位圖。 遮罩中的每個位都會對應到模式中的位元元組,並指定傳入封包中的對應位元組是否應該與模式中的對應位元組相符。 如果網路適配器比對所比較的所有位元組,封包就是相符專案,而且網路適配器應該會產生喚醒事件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 (版本 2004) |
最低UMDF版本 | 2.33 |
標頭 | netwakesource.h (包含 netadaptercx.h) |