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

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 2004
Минимальная версия UMDF 2.33
Верхняя часть netwakesource.h (включая netadaptercx.h)

См. также раздел

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

NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT

NetWakeSourceGetBitmapParameters