OID_PM_GET_PROTOCOL_OFFLOAD
Ein überlagernder Treiber stellt eine OID-Methodenanforderung von OID_PM_GET_PROTOCOL_OFFLOAD aus, um Parametereinstellungen für eine Protokollauslagerung mit geringer Leistung von einem Netzwerkadapter abzurufen.
Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält zunächst einen Zeiger auf einen ULONG-Protokollauslagerungsbezeichner. Nach erfolgreicher 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 eine Protokollabladung mit geringer Leistung von einem Netzwerkadapter abzurufen.
Der Informationspuffer muss auf einen Protokollauslagerungsbezeichner vom Typ ULONG verweisen. NDIS legt diesen Protokollauslagerungsbezeichner im 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 status Codes 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 status Code und die Ergebnisse werden an den OID-Anforderungsabschlusshandler des Aufrufers übergeben.
NDIS_STATUS_INVALID_PARAMETER
Der angegebene Protokollauslagerungsbezeichner war ungültig.
NDIS_STATUS_BUFFER_TOO_SHORT
Der Informationspuffer war zu kurz. NDIS legt die DATEN fest. QUERY_INFORMATION. BytesNeed-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.
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.20 und höher. Obligatorisch für Miniporttreiber. (Siehe Abschnitt Hinweise.) |
Header |
Ntddndis.h (include Ndis.h) |