estrutura NET_WAKE_SOURCE_BITMAP_PARAMETERS (netwakesource.h)

A estrutura NET_WAKE_SOURCE_BITMAP_PARAMETERS contém parâmetros para uma fonte de ativação de padrão de bitmap (WoL) wake-on-LAN.

Sintaxe

typedef struct _NET_WAKE_SOURCE_BITMAP_PARAMETERS {
  ULONG       Size;
  ULONG       Id;
  UCHAR const *Pattern;
  SIZE_T      PatternSize;
  UCHAR const *Mask;
  SIZE_T      MaskSize;
} NET_WAKE_SOURCE_BITMAP_PARAMETERS;

Membros

Size

O tamanho dessa estrutura, em bytes.

Id

O identificador dessa fonte de ativação.

Pattern

Uma sequência de bytes que contém um padrão com o qual comparar bytes em um pacote de entrada.

PatternSize

O tamanho do padrão de bitmap, em bytes.

Mask

Uma máscara que especifica quais bytes em pacotes de entrada devem ser correspondidos com o padrão de bitmap. Cada bit na máscara de bits corresponde a um byte no padrão. Se um bit for zero, o byte correspondente no pacote de entrada não deverá ser correspondente ao padrão. Se o bit for um, o adaptador de rede comparará o byte no pacote de entrada com o byte especificado no padrão.

MaskSize

O tamanho da máscara, em bytes.

Comentários

Chame NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT para inicializar essa estrutura e preencher seu campo Tamanho . Depois de chamar NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT, chame NetWakeSourceGetBitmapParameters para preencher os outros membros da estrutura.

Um driver de camada superior pode especificar um padrão WOL genérico com o membro Pattern . Um padrão de bitmap é especificado como uma sequência de bytes e um bitmap de máscara, especificado no membro Mask . Cada bit na máscara corresponde a um byte no padrão e especifica se o byte correspondente no pacote de entrada deve ser correspondido com o byte correspondente no padrão. Se todos os bytes comparados pelo adaptador de rede corresponderem, o pacote será uma correspondência e o adaptador de rede deverá gerar um evento de ativação.

Requisitos

Confira também

Configurando o gerenciamento de energia

NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT

NetWakeSourceGetBitmapParameters