estructura NDIS_PM_WAKE_PACKET (ntddndis.h)

Artículo
02/29/2024

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 formato de estructura NDIS_OBJECT_HEADER .

El controlador de minipuerto debe establecer el miembro Type de Header en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_PM_WAKE_PACKET , el controlador debe establecer el miembro Revision de Header en el siguiente valor:

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1.

Flags

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

PatternId

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

PatternFriendlyName

Valor de NDIS_PM_COUNTED_STRING que contiene la descripción descriptivo del patrón de reactivación especificado por el miembro PatternId . Este valor lo especifica el miembro FriendlyName 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 minipuerto 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 los controladores de exceso.

OriginalPacketSize

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

SavedPacketSize

Valor 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 tener al menos min(wake packet size, 128) bytes.

SavedPacketOffset

Valor de ULONG 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 inicio 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 alinearse en un límite de 64 bits.

Comentarios

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, consulte Emisión de indicaciones de estado de motivo de reactivación NDIS.