OID_PM_REMOVE_PROTOCOL_OFFLOAD
Come richiesta impostata, i driver di protocollo e NDIS usano l'OID OID_PM_REMOVE_PROTOCOL_OFFLOAD per rimuovere un offload del protocollo di risparmio energia da una scheda di rete. Il membro InformationBuffer della struttura di NDIS_OID_REQUEST contiene un puntatore a un identificatore di offload del protocollo ULONG.
Osservazioni
I driver di protocollo e NDIS usano l'OID OID_PM_REMOVE_PROTOCOL_OFFLOAD per rimuovere un offload del protocollo dalla scheda di rete sottostante.
The DATA. SET_INFORMATION. InformationBuffer membro della struttura NDIS_OID_REQUEST deve puntare a un valore di ULONG per un identificatore di offload del protocollo aggiunto in precedenza. NDIS imposta questo identificatore di offload del protocollo nel membro ProtocolOffloadId della struttura NDIS_PM_PROTOCOL_OFFLOAD quando NDIS ha inviato la richiesta OID OID_PM_ADD_PROTOCOL_OFFLOAD precedente alla scheda di rete sottostante.
Osservazioni per i writer di driver miniport
NDIS garantisce che la dimensione del buffer sia almeno sizeof(ULONG) e contenga un ID di offload del protocollo valido. Pertanto, la funzione diMiniportOidRequest di un driver miniport deve restituire NDIS_STATUS_SUCCESS per questa richiesta.
Nota Se il driver miniport è reimpostato, la funzioneMiniportOidRequestdeve restituire NDIS_STATUS_NOT_ACCEPTED.
Restituire i codici di stato
NDIS restituisce uno dei codici di stato seguenti per questa richiesta:
NDIS_STATUS_SUCCESS
L'offload del protocollo è stato rimosso correttamente.
NDIS_STATUS_PENDING
La richiesta è in attesa di completamento. NDIS passerà il codice di stato finale e i risultati al gestore di completamento della richiesta OID del chiamante dopo il completamento della richiesta.
NDIS_STATUS_INVALID_LENGTH
Il buffer delle informazioni è troppo piccolo. NDIS imposta l'DATA. SET_INFORMATION. BytesNeeded membro nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie, in byte.
NDIS_STATUS_FILE_NOT_FOUND
L'identificatore di offload del protocollo nella richiesta OID non è valido.
Fabbisogno
Versione |
Supportato in NDIS 6.20 e versioni successive. Obbligatorio per i driver miniport. |
Intestazione |
Ntddndis.h (include Ndis.h) |