estrutura NDIS_PM_WAKE_PACKET (ntddndis.h)

Artigo
08/07/2023

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 miniporta deve definir o membro Type de Header como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_PM_WAKE_PACKET , o driver deve definir o membro Revision de Header com o seguinte valor:

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1.

Flags

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

PatternId

Um valor ULONG 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 NDIS_PM_WOL_PATTERN que é passada para o driver durante uma solicitação OID de OID_PM_ADD_WOL_PATTERN.

Nota O driver de miniporta não precisa inicializar esse membro. O NDIS define o membro PatternFriendlyName com 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.

Nota 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 NDIS_PM_WAKE_PACKET até o início de um buffer que contém o pacote de ativação.

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

Comentários

A estrutura NDIS_PM_WAKE_PACKET é usada na indicação 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.