Compartilhar via


NET_WAKE_SOURCE_BITMAP_PARAMETERS estrutura (netwakesource.h)

A estrutura de 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 em relação ao qual comparar bytes em um pacote de entrada.

PatternSize

O tamanho do padrão 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.

Observações

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 padrão. Um padrão bitmap é especificado como uma sequência de bytes e um bitmap de máscara, especificado no membro máscara. 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
de cliente com suporte mínimo Windows 10, versão 2004
versão mínima do UMDF 2.33
cabeçalho netwakesource.h (inclua netadaptercx.h)

Consulte também

Configurando de gerenciamento de energia

NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT

NetWakeSourceGetBitmapParameters