NDIS_PM_WAKE_PACKET estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_PM_WAKE_PACKET descreve um pacote de rede (conhecido como pacote de ativação) que fez com que o adaptador de rede gerasse um evento de ativação.

Sintaxe

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;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_PM_WAKE_PACKET. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER.

O driver de miniporto deve definir o membro tipo do de cabeçalho para NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_PM_WAKE_PACKET, o driver deve definir o membro de revisão do Header para o seguinte valor:

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1.

Flags

Um valor de ULONG que contém um OR bit a bit de sinalizadores. Este membro é reservado para NDIS.

PatternId

Um ULONG valor que especifica o identificador do padrão WOL (wake-on-LAN) que corresponde ao pacote de ativação. Esse identificador é especificado pelo membro PatternId da estrutura NDIS_PM_WOL_PATTERN que é passada para o driver durante uma solicitação de conjunto OID de OID_PM_ADD_WOL_PATTERN.

PatternFriendlyName

Um valor NDIS_PM_COUNTED_STRING que contém a descrição amigável do padrão de ativação especificado pelo membro PatternId. Esse valor é especificado pelo membro FriendlyName da estrutura de NDIS_PM_WOL_PATTERN que é passada para o driver durante uma solicitação OID de OID_PM_ADD_WOL_PATTERN.

Observação O driver de miniporto não precisa inicializar esse membro. O NDIS define o membro PatternFriendlyName como o valor correto antes de passar a estrutura NDIS_PM_WAKE_PACKET para drivers sobressociá-los.

OriginalPacketSize

Um valor ULONG que especifica o comprimento original, em unidades de bytes, do pacote de ativação.

SavedPacketSize

Um valor ULONG que especifica o comprimento, em unidades de bytes, dos dados do pacote de ativação que seguem essa estrutura.

Observação O valor desse membro deve, pelo menos, min(wake packet size, 128) bytes.

SavedPacketOffset

Um valor ULONG que especifica o deslocamento, em unidades de bytes, para os dados do pacote de ativação que seguem essa estrutura. O deslocamento é medido desde o início da estrutura de NDIS_PM_WAKE_PACKET até o início de um buffer que contém o pacote de ativação.

Observação O deslocamento para o pacote de ativação salvo deve ser alinhado em um limite de 64 bits.

Observações

A estrutura de NDIS_PM_WAKE_PACKET é usada na indicação de status NDIS_STATUS_PM_WAKE_REASON. Para obter mais informações sobre como emitir essa indicação de status, consulte Emitindo indicações de status de motivo de ativação do NDIS.