OID_PM_GET_PROTOCOL_OFFLOAD

Un driver overlying emette una richiesta di metodo OID di OID_PM_GET_PROTOCOL_OFFLOAD per ottenere le impostazioni dei parametri per un offload di protocollo a basso consumo da una scheda di rete.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene inizialmente un puntatore a un identificatore di offload del protocollo ULONG. Una volta restituito correttamente dalla richiesta del metodo OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_PM_PROTOCOL_OFFLOAD.

Osservazioni

I driver di protocollo NDIS 6.20 e versioni successive usano OID_PM_GET_PROTOCOL_OFFLOAD OID del metodo per recuperare le impostazioni dei parametri per un offload del protocollo a basso consumo da una scheda di rete.

Il buffer delle informazioni deve puntare a un identificatore di offload del protocollo di tipo ULONG. 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.

Il driver miniport restituisce uno dei codici di stato seguenti per la richiesta:

NDIS_STATUS_SUCCESS
I dati richiesti sono stati recuperati correttamente. Il buffer delle informazioni contiene la struttura di NDIS_PM_PROTOCOL_OFFLOAD corrispondente.

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_INVALID_PARAMETER
L'identificatore di offload del protocollo specificato non è valido.

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_NOT_SUPPORTED
La versione NDIS del driver miniport è inferiore alla 6.20.

NDIS_STATUS_FAILURE
La richiesta non è riuscita per motivi diversi dai motivi precedenti.

Fabbisogno

Versione	Supportato in NDIS 6.20 e versioni successive. Obbligatorio per i driver miniport. Vedere la sezione Osservazioni.
Intestazione	Ntddndis.h (include Ndis.h)

Vedere anche

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD