OID_PM_PROTOCOL_OFFLOAD_LIST
Come query, i driver overlying possono usare l'OID OID_PM_PROTOCOL_OFFLOAD_LIST per enumerare gli offload del protocollo impostati su una scheda di rete sottostante. Una volta restituito correttamente dalla richiesta di query OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a un elenco di strutture NDIS_PM_PROTOCOL_OFFLOAD che descrivono gli offload del protocollo attualmente attivo.
Commenti
NDIS gestisce la query per i driver miniport. I driver NDIS possono usare l'OID OID_PM_PROTOCOL_OFFLOAD_LIST per ottenere un elenco di offload di protocollo impostati su una scheda di rete sottostante.
Per ogni struttura NDIS_PM_PROTOCOL_OFFLOAD nell'elenco, NDIS imposta il membro NextProtocolOffloadOffset 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_PROTOCOL_OFFLOAD successiva nell'elenco. L'offset nel membro NextProtocolOffloadOffset dell'ultima struttura nell'elenco è zero.
Se non sono presenti offload di protocollo impostati nella scheda di rete, NDIS imposta i DATI. QUERY_INFORMATION. Membro BytesWritten della struttura NDIS_OID_REQUEST su zero e restituisce NDIS_STATUS_SUCCESS. 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 offload del protocollo, 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) |