NDIS_PM_WOL_PATTERN struttura (ntddndis.h)

Articolo
08/07/2023

La struttura NDIS_PM_WOL_PATTERN definisce un modello wake-on-LAN (WOL).

Sintassi

typedef struct _NDIS_PM_WOL_PATTERN {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  ULONG                  Priority;
  NDIS_PM_WOL_PACKET     WoLPacketType;
  NDIS_PM_COUNTED_STRING FriendlyName;
  ULONG                  PatternId;
  ULONG                  NextWoLPatternOffset;
  union {
    struct {
      ULONG  Flags;
      UCHAR  IPv4SourceAddress[4];
      UCHAR  IPv4DestAddress[4];
      USHORT TCPSourcePortNumber;
      USHORT TCPDestPortNumber;
    } IPv4TcpSynParameters;
    struct {
      ULONG  Flags;
      UCHAR  IPv6SourceAddress[16];
      UCHAR  IPv6DestAddress[16];
      USHORT TCPSourcePortNumber;
      USHORT TCPDestPortNumber;
    } IPv6TcpSynParameters;
    struct {
      ULONG Flags;
    } EapolRequestIdMessageParameters;
    struct {
      ULONG Flags;
      ULONG MaskOffset;
      ULONG MaskSize;
      ULONG PatternOffset;
      ULONG PatternSize;
    } WoLBitMapPattern;
  } WoLPattern;
  _WOL_PATTERN           _WOL_PATTERN;
} NDIS_PM_WOL_PATTERN, *PNDIS_PM_WOL_PATTERN;

Members

Header

Tipo, revisione e dimensione della struttura NDIS_PM_WOL_PATTERN . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare il membro Type di Intestazione su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_PM_WOL_PATTERN , il driver deve impostare il membro Revisionedell'intestazione sul valore seguente:

NDIS_PM_WOL_PATTERN_REVISION_2

Revisioni apportate all'enumerazione NDIS_PM_WOL_PACKET per NDIS 6.30.

Impostare il membro Size su NDIS_SIZEOF_NDIS_PM_WOL_PATTERN_REVISION_2.

NDIS_PM_WOL_PATTERN_REVISION_1

Versione originale per NDIS 6.20.

Impostare il membro Size su NDIS_SIZEOF_NDIS_PM_WOL_PATTERN_REVISION_1.

Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

Priority

Valore ULONG che contiene la priorità del modello WOL. Se un driver overlying aggiunge un modello WOL con priorità superiore quando non sono disponibili risorse per altri modelli WOL, NDIS potrebbe rimuovere un modello WOL con priorità inferiore per liberare risorse. I driver miniport devono ignorare questo membro. Un driver di protocollo può specificare qualsiasi priorità all'interno dell'intervallo predefinito. I valori seguenti sono predefiniti:

NDIS_PM_WOL_PRIORITY_LOWEST

Specifica il modello WOL con priorità più bassa.

NDIS_PM_WOL_PRIORITY_NORMAL

Specifica un modello WOL con priorità normale.

NDIS_PM_WOL_PRIORITY_HIGHEST

Specifica il modello WOL con priorità più alta.

WoLPacketType

Valore di enumerazione NDIS_PM_WOL_PACKET che specifica il tipo del pacchetto WOL.

FriendlyName

Struttura NDIS_PM_COUNTED_STRING che contiene la descrizione leggibile dell'utente del pacchetto WOL.

PatternId

Valore ULONG che contiene un valore fornito da NDIS che identifica il modello WOL. Prima che NDIS invii la richiesta OID OID_PM_ADD_WOL_PATTERN fino ai driver NDIS sottostanti o completa la richiesta al driver overlying, NDIS imposta PatternId su un valore univoco tra i modelli WOL in una scheda di rete.

NextWoLPatternOffset

Valore ULONG che contiene un offset, in byte. Il membro NextWoLPatternOffset di ogni struttura NDIS_PM_WOL_PATTERN in un elenco viene impostato sull'offset (dall'inizio della richiesta OID InformationBuffer) della struttura NDIS_PM_WOL_PATTERN successiva nell'elenco. Se NextWoLPatternOffset è zero, la struttura corrente è l'ultima struttura nell'elenco.

WoLPattern

Unione che contiene le strutture membro seguenti.

WoLPattern.IPv4TcpSynParameters

Struttura che contiene informazioni TCP SYN IPv4. Questa struttura contiene i membri seguenti:

WoLPattern.IPv4TcpSynParameters.Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

WoLPattern.IPv4TcpSynParameters.IPv4SourceAddress[4]

Indirizzo di origine IPv4 nel pacchetto TCP SYN.

WoLPattern.IPv4TcpSynParameters.IPv4DestAddress[4]

Indirizzo di destinazione IPv4 nel pacchetto TCP SYN.

WoLPattern.IPv4TcpSynParameters.TCPSourcePortNumber

Numero di porta di origine TCP nel pacchetto TCP SYN.

WoLPattern.IPv4TcpSynParameters.TCPDestPortNumber

Numero di porta di destinazione TCP nel pacchetto TCP SYN.

WoLPattern.IPv6TcpSynParameters

Struttura che contiene informazioni TCP SYN IPv6. Questa struttura contiene i membri seguenti:

WoLPattern.IPv6TcpSynParameters.Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

WoLPattern.IPv6TcpSynParameters.IPv6SourceAddress[16]

Indirizzo di origine IPv6 nel pacchetto TCP SYN.

WoLPattern.IPv6TcpSynParameters.IPv6DestAddress[16]

Indirizzo di destinazione IPv6 nel pacchetto TCP SYN.

WoLPattern.IPv6TcpSynParameters.TCPSourcePortNumber

Porta di origine TCP nel pacchetto TCP SYN.

WoLPattern.IPv6TcpSynParameters.TCPDestPortNumber

Porta di destinazione TCP nel pacchetto TCP SYN.

WoLPattern.EapolRequestIdMessageParameters

Struttura che contiene parametri di messaggio di identità della richiesta EAPOL 802.1X. Questa struttura contiene i membri seguenti:

WoLPattern.EapolRequestIdMessageParameters.Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

WoLPattern.WoLBitMapPattern

Struttura che specifica un modello bitmap WOL. Per altre informazioni sui modelli bitmap, vedere la sezione Osservazioni. La struttura ha i membri seguenti:

WoLPattern.WoLBitMapPattern.Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

WoLPattern.WoLBitMapPattern.MaskOffset

Offset, in byte, per un buffer maschera dall'inizio della struttura NDIS_PM_WOL_PATTERN.

La maschera specifica quali byte nei pacchetti in ingresso devono essere corrispondenti al 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 modello. Se il bit è uno, la scheda di rete confronta il byte con il pacchetto in ingresso con il byte specificato nel modello.

WoLPattern.WoLBitMapPattern.MaskSize

Dimensioni, in byte, della maschera.

WoLPattern.WoLBitMapPattern.PatternOffset

Offset, in byte, per un buffer del modello dall'inizio della struttura NDIS_PM_WOL_PATTERN.

WoLPattern.WoLBitMapPattern.PatternSize

Dimensioni, in byte, del modello.

_WOL_PATTERN

Commenti

La struttura NDIS_PM_WOL_PATTERN viene usata nelle richieste OID_PM_ADD_WOL_PATTERN e OID_PM_WOL_PATTERN_LIST OID.

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

Un driver superiore può specificare valori di porta IPv4 o non specificati nella struttura membro IPv4SynParameters . Se il flag NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED è impostato nel membro EnabledWoLPacketPatterns del NDIS_PM_PARAMETERS, la scheda di rete deve utilizzare il valore di indirizzo o porta non specificato per corrispondere a qualsiasi indirizzo IPv4 di origine o destinazione o valore di porta TCP nel pacchetto TCP SYN IPv4.

Analogamente, un driver di livello superiore può specificare un indirizzo IPv6 non specificato e valori di porta TCP nella struttura membro IPv6TcpSynParameters . Se il flag di NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED è impostato nel membro EnabledWoLPacketPatterns del NDIS_PM_PARAMETERS, la scheda di rete deve usare il valore di indirizzo o porta non specificato per corrispondere a qualsiasi indirizzo IPv6 di origine o destinazione o valore di porta TCP nel pacchetto TCP SYN IPv4.

Il driver di livello superiore imposta i flag di NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED e NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED inviando una richiesta set dell'OID OID_PM_PARAMETERS.