структура NET_WAKE_SOURCE_BITMAP_PARAMETERS (netwakesource.h)

Статья
02/07/2025

Структура 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, чтобы заполнить другие элементы структуры.

Драйвер верхнего уровня может указать универсальный шаблон WOL с элементом Pattern. Шаблон растрового изображения указывается в виде последовательности байтов и растровой карты маски, указанной в элементе Mask. Каждый бит в маске соответствует байту в шаблоне и указывает, должен ли соответствующий байт в входящих пакетах соответствовать соответствующему байту в шаблоне. Если все байты по сравнению с сетевым адаптером совпадают, пакет соответствует, а сетевой адаптер должен создать событие пробуждения.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 2004
минимальная версия UMDF	2.33
заголовка	netwakesource.h (include netadaptercx.h)

См. также

настройка управления питанием

NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT

NetWakeSourceGetBitmapParameters

Поделиться через