struttura NDIS_PM_WAKE_PACKET (ntddndis.h)

2025-02-07

La struttura NDIS_PM_WAKE_PACKET descrive un pacchetto di rete ,noto come pacchetto di riattivazione ) che ha causato la generazione di un evento di riattivazione della scheda di rete.

Sintassi

typedef struct _NDIS_PM_WAKE_PACKET {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  ULONG                  PatternId;
  NDIS_PM_COUNTED_STRING PatternFriendlyName;
  ULONG                  OriginalPacketSize;
  ULONG                  SavedPacketSize;
  ULONG                  SavedPacketOffset;
} NDIS_PM_WAKE_PACKET, *PNDIS_PM_WAKE_PACKET;

Membri

Header

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

Il driver miniport deve impostare il membro type di Header su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura di NDIS_PM_WAKE_PACKET, il driver deve impostare il membro revision di Header sul valore seguente:

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro dimensioni su NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1.

Flags

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

PatternId

Valore ULONG che specifica l'identificatore del modello di riattivazione LAN (WOL) che corrisponde al pacchetto di riattivazione. Questo identificatore viene specificato dal membro PatternId della struttura NDIS_PM_WOL_PATTERN passata al driver durante una richiesta di set OID di OID_PM_ADD_WOL_PATTERN.

PatternFriendlyName

Valore NDIS_PM_COUNTED_STRING che contiene la descrizione descrittiva del modello di riattivazione specificato dal membro PatternId. Questo valore viene specificato dal membro friendlyName della struttura NDIS_PM_WOL_PATTERN passata al driver durante una richiesta OID di OID_PM_ADD_WOL_PATTERN.

Nota Il driver miniport non deve inizializzare questo membro. NDIS imposta il membro PatternFriendlyName sul valore corretto prima di passare la struttura NDIS_PM_WAKE_PACKET ai driver overlying.

OriginalPacketSize

Valore ULONG che specifica la lunghezza originale, in unità di byte, del pacchetto di riattivazione.

SavedPacketSize

Valore ULONG che specifica la lunghezza, in unità di byte, dei dati del pacchetto di riattivazione che seguono questa struttura.

Nota Il valore di questo membro deve almeno min(wake packet size, 128) byte.

SavedPacketOffset

Valore ULONG che specifica l'offset, in unità di byte, ai dati del pacchetto di riattivazione che seguono questa struttura. L'offset viene misurato dall'inizio della struttura NDIS_PM_WAKE_PACKET all'inizio di un buffer che contiene il pacchetto di riattivazione.

Nota L'offset del pacchetto di riattivazione salvato deve essere allineato su un limite a 64 bit.

Osservazioni

La struttura NDIS_PM_WAKE_PACKET viene utilizzata nell'indicazione dello stato NDIS_STATUS_PM_WAKE_REASON. Per altre informazioni su come emettere questa indicazione di stato, vedere NDIS Wake Reason Status Indications.For more information about how to issue this status indication, see Issue NDIS Wake Reason Status Indications.