NET_WAKE_SOURCE_BITMAP_PARAMETERS-Struktur (netwakesource.h)

  • Artikel

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 Reaktivierungsquelle.

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 0 ist, sollte das entsprechende Byte im eingehenden Paket nicht mustergeglichen sein. 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. Nachdem Sie NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT aufgerufen haben, rufen Sie NetWakeSourceGetBitmapParameters auf, um die anderen Elemente der Struktur auszufüllen.

Ein Treiber der oberen Ebene kann ein generisches WOL-Muster mit dem Pattern-Element angeben. Ein Bitmapmuster wird als Eine Sequenz von Bytes und eine Masken-Bitmap angegeben, die im Mask-Element angegeben wird. 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 durch den 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
Kopfzeile netwakesource.h (include netadaptercx.h)

Weitere Informationen

Konfigurieren der Energieverwaltung

NET_WAKE_SOURCE_BITMAP_PARAMETERS_INIT

NetWakeSourceGetBitmapParameters