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 attivi.
Osservazioni
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 dell'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. Offset nel NextProtocolOffloadOffset membro dell'ultima struttura nell'elenco è zero.
Se non sono presenti offload di protocollo impostati nella scheda di rete, NDIS imposta il DATA. QUERY_INFORMATION. Byte Scritti membro della struttura NDIS_OID_REQUEST su zero e restituisce NDIS_STATUS_SUCCESS. Dati all'interno del DATA. QUERY_INFORMATION. InformationBuffer membro non viene modificato da NDIS.
NDIS restituisce uno dei codici di stato seguenti per la richiesta:
NDIS_STATUS_SUCCESS
La richiesta è stata completata correttamente. Il 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 l'DATA. QUERY_INFORMATION. BytesNeeded membro nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.
NDIS_STATUS_FAILURE
La richiesta non è riuscita per motivi diversi dai motivi precedenti.
Fabbisogno
Versione |
Supportato in NDIS 6.20 e versioni successive. Non richiesto per i driver miniport. Vedere la sezione Osservazioni. |
Intestazione |
Ntddndis.h (include Ndis.h) |