Condividi tramite


struttura NET_WAKE_SOURCE_BITMAP_PARAMETERS (netwakesource.h)

La struttura NET_WAKE_SOURCE_BITMAP_PARAMETERS contiene parametri per un'origine di riattivazione del modello bitmap wol (Wake-On-LAN).

Sintassi

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;

Members

Size

Dimensioni di questa struttura, in byte.

Id

Identificatore per questa origine di riattivazione.

Pattern

Sequenza di byte che contiene un criterio in base al quale confrontare i byte in un pacchetto in ingresso.

PatternSize

Dimensioni del modello bitmap, in byte.

Mask

Maschera che specifica quali byte nei pacchetti in ingresso devono essere confrontati con il modello bitmap. Ogni bit nella maschera di bit corrisponde a un byte nel modello. Se un bit è zero, il byte corrispondente nel pacchetto in ingresso non deve corrispondere al criterio. Se il bit è uno, la scheda di rete confronta il byte nel pacchetto in ingresso con il byte specificato nel modello.

MaskSize

Dimensione della maschera, in byte.

Commenti

Chiamare NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT per inizializzare questa struttura e compilare il relativo campo Dimensioni . Dopo aver chiamato NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT, chiamare NetWakeSourceGetBitmapParameters per compilare gli altri membri della struttura.

Un driver di livello superiore può specificare un modello WOL generico con il membro Pattern . Un criterio bitmap viene specificato come sequenza di byte e una bitmap mask, specificata nel membro Mask . Ogni bit nella maschera corrisponde a un byte nel criterio e specifica se il byte corrispondente nel pacchetto in ingresso deve essere confrontato con il byte corrispondente nel criterio. Se tutti i byte confrontati con la scheda di rete corrispondono, il pacchetto è una corrispondenza e la scheda di rete deve generare un evento di riattivazione.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 2004
Versione UMDF minima 2.33
Intestazione netwakesource.h (include netadaptercx.h)

Vedi anche

Configurazione del risparmio energia

NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT

NetWakeSourceGetBitmapParameters