Freigeben über


NET_WAKE_SOURCE_BITMAP_PARAMETERS-Struktur (netwakesource.h)

Die NET_WAKE_SOURCE_BITMAP_PARAMETERS-Struktur enthält Parameter für eine Wake-on-LAN(WoL)-Bitmapmusterreaktivierungsquelle.

Syntax

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;

Member

Size

Die Größe dieser Struktur in Bytes.

Id

Der Bezeichner für diese Aktivierungsquelle.

Pattern

Eine Bytesequenz, die ein Muster enthält, mit dem Bytes in einem eingehenden Paket verglichen werden sollen.

PatternSize

Die Größe des Bitmapmusters in Bytes.

Mask

Eine Maske, die angibt, welche Bytes in eingehenden Paketen mit dem Bitmapmuster abgeglichen werden sollen. Jedes Bit in der Bitmaske entspricht einem Byte im Muster. Wenn ein Bit null ist, sollte das entsprechende Byte im eingehenden Paket nicht mustergeglichen werden. Wenn das Bit eins ist, vergleicht der Netzwerkadapter das Byte im eingehenden Paket mit dem im Muster angegebenen Byte.

MaskSize

Die Größe der Maske in Bytes.

Hinweise

Rufen Sie NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT auf, um diese Struktur zu initialisieren, und füllen Sie das Feld Größe aus. Rufen Sie nach dem Aufrufen NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT NetWakeSourceGetBitmapParameters auf, um die anderen Member der -Struktur auszufüllen.

Ein Treiber der oberen Ebene kann ein generisches WOL-Muster mit dem Pattern-Member angeben. Ein Bitmapmuster wird als Bytesequenz und als Maskenbitbitbit angegeben, die im Mask-Element angegeben sind. Jedes Bit in der Maske entspricht einem Byte im Muster und gibt an, ob das entsprechende Byte im eingehenden Paket mit dem entsprechenden Byte im Muster abgeglichen werden soll. Wenn alle vom Netzwerkadapter verglichenen Bytes übereinstimmen, ist das Paket eine Übereinstimmung, und der Netzwerkadapter sollte ein Aktivierungsereignis generieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 2004
UMDF-Mindestversion 2.33
Kopfzeile netwakesource.h (include netadaptercx.h)

Weitere Informationen

Konfigurieren der Energieverwaltung

NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT

NetWakeSourceGetBitmapParameters