NDIS_PM_WOL_PATTERN struttura (ntddndis.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato in NDIS 6.20 e versioni successive. |
| Intestazione | ntddndis.h (include Ntddndis.h) |