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

Статья
02/07/2025

Структура 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.

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

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 (include Ndis.h)

См. также

NDIS_OBJECT_HEADER

NDIS_PM_COUNTED_STRING

NDIS_PM_WOL_PATTERN

NDIS_STATUS_PM_WAKE_REASON

OID_PM_ADD_WOL_PATTERN

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