OID_PNP_ADD_WAKE_UP_PATTERN
L'OID OID_PNP_ADD_WAKE_UP_PATTERN viene inviato da un driver di protocollo a un driver miniport per specificare un modello di riattivazione. Il modello di riattivazione, insieme alla maschera, è descritto da una struttura NDIS_PM_PACKET_PATTERN .
Un protocollo che consente la riattivazione del modello di corrispondenza per un driver miniport (vedere OID_PNP_ENABLE_WAKE_UP) usa OID_PNP_ADD_WAKE_UP_PATTERN per specificare un modello di riattivazione. Il modello di riattivazione può essere archiviato in memoria host o nella scheda di rete, a seconda delle funzionalità della scheda di rete.
Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene quanto segue:
Struttura NDIS_PM_PACKET_PATTERN che fornisce informazioni sul modello e sulla relativa maschera.
Maschera che indica quali byte di un pacchetto in ingresso devono essere confrontati con i byte corrispondenti nel criterio. La maschera inizia con il primo byte del pacchetto. La maschera segue immediatamente la struttura NDIS_PM_PACKET_PATTERN in InformationBuffer. Per altre informazioni sul funzionamento di questa maschera, vedere la specifica di riferimento per il risparmio energia della classe dispositivo di rete.
Modello di riattivazione, che inizia i byte PatternOffset dall'inizio di InformationBuffer. Per altre informazioni sui modelli di riattivazione, vedere la specifica di riferimento per il risparmio energia della classe di dispositivi di rete.
Il numero di modelli di riattivazione che il driver miniport può accettare da un protocollo può dipendere dalla disponibilità delle risorse, ad esempio dalla memoria host allocata dal driver miniport per tali modelli o dalla risorsa di archiviazione disponibile nella scheda di rete. Se un driver miniport non può aggiungere un modello di riattivazione a causa di risorse insufficienti, il driver miniport restituisce NDIS_STATUS_RESOURCES in risposta a OID_PNP_ADD_WAKE_UP_PATTERN.
Se un driver di protocollo tenta di aggiungere un modello duplicato, il driver miniport deve restituire NDIS_STATUS_INVALID_DATA in risposta a OID_PNP_ADD_WAKE_UP_PATTERN.
Un driver intermedio in cui il bordo superiore riceve questa richiesta OID deve sempre propagare la richiesta al driver miniport sottostante chiamando NdisRequest o NdisCoRequest.
Requisiti
Versione |
Supportato in NDIS 6.0 e NDIS 6.1. Per NDIS 6.20 e versioni successive, usare invece OID_PM_ADD_WOL_PATTERN . |
Intestazione |
Ntddndis.h (include Ndis.h) |