структура NDIS_PM_WAKE_PACKET (ntddndis.h)

Статья
08/07/2023

Структура NDIS_PM_WAKE_PACKET описывает сетевой пакет (известный как пакет пробуждения), который вызвал событие пробуждения сетевого адаптера.

Синтаксис

typedef struct _NDIS_PM_WAKE_PACKET {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  ULONG                  PatternId;
  NDIS_PM_COUNTED_STRING PatternFriendlyName;
  ULONG                  OriginalPacketSize;
  ULONG                  SavedPacketSize;
  ULONG                  SavedPacketOffset;
} NDIS_PM_WAKE_PACKET, *PNDIS_PM_WAKE_PACKET;

Члены

Header

Тип, редакция и размер структуры NDIS_PM_WAKE_PACKET . Этот элемент отформатирован как структура NDIS_OBJECT_HEADER .

Драйвер мини-порта должен задать для элемента Typeзаголовка значение NDIS_OBJECT_TYPE_DEFAULT. Чтобы указать версию структуры NDIS_PM_WAKE_PACKET , драйвер должен задать для элемента Revisionэлемента Header следующее значение:

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

Исходная версия для NDIS 6.30 и более поздних версий.

Задайте для элемента Размер значение NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1.

Flags

Значение ULONG , содержащее побитовое ИЛИ флагов. Этот элемент зарезервирован для NDIS.

PatternId

Значение ULONG , указывающее идентификатор шаблона пробуждения по локальной сети (WOL), соответствующего пакету пробуждения. Этот идентификатор задается элементом PatternId структуры NDIS_PM_WOL_PATTERN , который передается драйверу во время запроса набора OID OID_PM_ADD_WOL_PATTERN.

PatternFriendlyName

Значение NDIS_PM_COUNTED_STRING , содержащее понятное описание шаблона пробуждения, указанного элементом PatternId . Это значение задается членом FriendlyName структуры NDIS_PM_WOL_PATTERN , передаваемой драйверу во время запроса OID OID_PM_ADD_WOL_PATTERN.

Примечание Драйверу мини-порта не нужно инициализировать этот элемент. NDIS устанавливает для элемента PatternFriendlyName правильное значение, прежде чем он передает структуру NDIS_PM_WAKE_PACKET в более чем движущиеся драйверы.

OriginalPacketSize

Значение ULONG , указывающее исходную длину пакета пробуждения в единицах в байтах.

SavedPacketSize

Значение ULONG , указывающее длину (в единицах байт) данных пакета пробуждения, следующих за этой структурой.

Примечание Значение этого элемента должно быть не менее min(wake packet size, 128) байтов.

SavedPacketOffset

Значение ULONG , указывающее смещение (в единицах байтов) к данным пакета пробуждения, которые следуют за этой структурой. Смещение измеряется от начала структуры NDIS_PM_WAKE_PACKET до начала буфера, содержащего пакет пробуждения.

Примечание Смещение сохраненного пакета пробуждения должно быть выровнено по 64-разрядной границе.

Структура NDIS_PM_WAKE_PACKET используется в указании состояния NDIS_STATUS_PM_WAKE_REASON . Дополнительные сведения о том, как выдать это указание состояния, см. в разделе Выдача индикаторов состояния причины пробуждения NDIS.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.30 и более поздних версиях.
Верхняя часть	ntddndis.h (включая Ndis.h)