OID_PM_WOL_PATTERN_LIST
Come query, i driver overlying possono usare l'OID OID_PM_WOL_PATTERN_LIST per enumerare i modelli di riattivazione LAN impostati su una scheda di rete sottostante. Una volta restituito correttamente dalla query, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a un elenco di strutture NDIS_PM_WOL_PATTERN che descrivono i modelli WOL attualmente aggiunti.
Commenti
NDIS gestisce la query per i driver miniport. I driver NDIS possono usare l'OID OID_PM_WOL_PATTERN_LIST per ottenere un elenco di modelli di riattivazione LAN impostati su una scheda di rete sottostante.
Per ogni struttura NDIS_PM_WOL_PATTERN nell'elenco, NDIS imposta il membro NextWoLPatternOffset sull'offset dall'inizio del buffer delle informazioni OID, ovvero l'inizio del buffer a cui punta il membro InformationBuffer della struttura NDIS_OID_REQUEST ) all'inizio della struttura NDIS_PM_WOL_PATTERN successiva nell'elenco. L'offset nel membro NextWoLPatternOffset dell'ultima struttura nell'elenco è zero.
Per gli offset in una struttura NDIS_PM_WOL_PATTERN diversa da NextWoLPatternOffset (ad esempio , NameBufferOffset), NDIS fornisce offset relativi all'inizio di ogni struttura NDIS_PM_WOL_PATTERN .
Se nella scheda di rete non sono impostati modelli WOL, NDIS imposta i DATI. QUERY_INFORMATION. Membro BytesWritten della struttura NDIS_OID_REQUEST su zero e restituisce NDIS_STATUS_SUCCESS per la richiesta. Dati all'interno di DATA. QUERY_INFORMATION. Il membro InformationBuffer non viene modificato da NDIS.
NDIS restituisce uno dei codici di stato seguenti per la richiesta:
NDIS_STATUS_SUCCESS
La richiesta è stata completata correttamente. InformationBuffer contiene un puntatore a un elenco di modelli WOL, se presenti.
NDIS_STATUS_PENDING
La richiesta è in attesa di completamento. Il codice di stato finale e i risultati verranno passati al gestore di completamento della richiesta OID del chiamante.
NDIS_STATUS_BUFFER_TOO_SHORT
Il buffer delle informazioni era troppo breve. NDIS imposta i DATI. QUERY_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.
NDIS_STATUS_FAILURE
La richiesta non è riuscita per motivi diversi dai motivi precedenti.
Requisiti
Versione |
Supportato in NDIS 6.20 e versioni successive. Non richiesto per i driver miniport. Vedere la sezione Note. |
Intestazione |
Ntddndis.h (include Ndis.h) |