NET_WAKE_SOURCE_BITMAP_PARAMETERS結構 (netwakesource.h)
NET_WAKE_SOURCE_BITMAP_PARAMETERS 結構包含網路喚醒模式喚醒來源的參數。
語法
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 以初始化此結構,並填入其 Size 字段。 呼叫 NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT之後,呼叫 NetWakeSourceGetBitmapParameters 以填入結構的其他成員。
上層驅動程式可以使用 Pattern 成員來指定泛型 WOL 模式。 位圖模式會指定為位元組序列和遮罩位圖,指定於 Mask 成員中。 遮罩中的每個位都會對應到模式中的位元元組,並指定傳入封包中的對應位元組是否應該與模式中的對應位元組相符。 如果網路適配器比對所比較的所有位元組,封包會相符,而且網路適配器應該會產生喚醒事件。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 2004 |
最低 UMDF 版本 | 2.33 |
標頭 | netwakesource.h (包括 netadaptercx.h) |