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

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 2004
Versão mínima do UMDF	2.33
Cabeçalho	netwakesource.h (inclua netadaptercx.h)

Confira também

Configurando o gerenciamento de energia

NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT

NetWakeSourceGetBitmapParameters