estructura NDIS_PM_WAKE_PACKET (ntddndis.h)

Artículo
02/07/2025

La estructura NDIS_PM_WAKE_PACKET describe un paquete de red (conocido como paquete de reactivación) que provocó que el adaptador de red generara un evento de reactivación.

Sintaxis

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;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_PM_WAKE_PACKET. Este miembro tiene el formato de una estructura NDIS_OBJECT_HEADER.

El controlador de miniport debe establecer el miembro Type de Encabezado en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_PM_WAKE_PACKET, el controlador debe establecer el miembro Revisión de de Encabezado en el siguiente valor:

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro tamaño de en NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1.

Flags

Valor ULONG que contiene un OR bit a bit de marcas. Este miembro está reservado para NDIS.

PatternId

Valor de ULONG que especifica el identificador del patrón wake-on-LAN (WOL) que coincide con el paquete de reactivación. El PatternId especifica este identificador miembro de la estructura NDIS_PM_WOL_PATTERN que se pasa al controlador durante una solicitud de conjunto de OID de OID_PM_ADD_WOL_PATTERN.

PatternFriendlyName

Valor NDIS_PM_COUNTED_STRING que contiene la descripción fácil del patrón de reactivación especificado por el miembro PatternId. El FriendlyName especifica este valor miembro de la estructura NDIS_PM_WOL_PATTERN que se pasa al controlador durante una solicitud OID de OID_PM_ADD_WOL_PATTERN.

Nota El controlador de miniport no necesita inicializar este miembro. NDIS establece el miembro PatternFriendlyName en el valor correcto antes de pasar la estructura de NDIS_PM_WAKE_PACKET a controladores excesivos.

OriginalPacketSize

Valor ULONG que especifica la longitud original, en unidades de bytes, del paquete de reactivación.

SavedPacketSize

Valor de ULONG que especifica la longitud, en unidades de bytes, de los datos del paquete de reactivación que siguen a esta estructura.

Nota El valor de este miembro debe al menos min(wake packet size, 128) bytes.

SavedPacketOffset

Un ULONG valor que especifica el desplazamiento, en unidades de bytes, a los datos del paquete de reactivación que siguen a esta estructura. El desplazamiento se mide desde el principio de la estructura NDIS_PM_WAKE_PACKET hasta el principio de un búfer que contiene el paquete de reactivación.

Nota El desplazamiento al paquete de reactivación guardado debe estar alineado en un límite de 64 bits.

Observaciones

La estructura NDIS_PM_WAKE_PACKET se usa en la indicación de estado NDIS_STATUS_PM_WAKE_REASON. Para obtener más información sobre cómo emitir esta indicación de estado, vea Emisión de indicaciones de estado del motivo de reactivación de NDIS.