OID_PM_GET_PROTOCOL_OFFLOAD

Ein überlagernder Treiber gibt eine OID-Methodenanforderung von OID_PM_GET_PROTOCOL_OFFLOAD aus, um Parametereinstellungen für einen Stromsparmodus von einem Netzwerkadapter abzurufen.

Der InformationBuffer Member der NDIS_OID_REQUEST Struktur enthält zunächst einen Zeiger auf einen ULONG-Protokoll-Offloadbezeichner. Nach einer erfolgreichen Rückgabe der OID-Methodenanforderung enthält das InformationBuffer Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_PM_PROTOCOL_OFFLOAD Struktur.

Bemerkungen

NDIS 6.20 und höhere Protokolltreiber verwenden OID_PM_GET_PROTOCOL_OFFLOAD Methode OID, um Parametereinstellungen für einen Stromsparmodus von einem Netzwerkadapter abzurufen.

Der Informationspuffer muss auf einen ULONG-Protokoll-Offloadbezeichner verweisen. NDIS legt diesen Protokollausladebezeichner in der ProtocolOffloadId Member der NDIS_PM_PROTOCOL_OFFLOAD Struktur fest, wenn NDIS die vorherige OID_PM_ADD_PROTOCOL_OFFLOAD OID-Anforderung an den zugrunde liegenden Netzwerkadapter gesendet hat.

Der Miniporttreiber gibt einen der folgenden Statuscodes für die Anforderung zurück:

NDIS_STATUS_SUCCESS
Die angeforderten Daten wurden erfolgreich abgerufen. Der Informationspuffer enthält die entsprechende NDIS_PM_PROTOCOL_OFFLOAD Struktur.

NDIS_STATUS_PENDING
Die Anforderung steht aus. Der endgültige Statuscode und die Ergebnisse werden an den OID-Anforderungsabschlusshandler des Aufrufers übergeben.

NDIS_STATUS_INVALID_PARAMETER
Der angegebene Protokoll-Offloadbezeichner war ungültig.

NDIS_STATUS_BUFFER_TOO_SHORT
Der Informationspuffer war zu kurz. NDIS legt die DATA fest. QUERY_INFORMATION. BytesNeeded Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_NOT_SUPPORTED
Die NDIS-Version des Miniporttreibers liegt unter 6.20.

NDIS_STATUS_FAILURE
Die Anforderung ist aus anderen Gründen als den vorherigen Gründen fehlgeschlagen.

Anforderungen

Siehe auch

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD