Freigeben über


OID_PM_PROTOCOL_OFFLOAD_LIST

Als Abfrage können Überlagerungstreiber das OID_PM_PROTOCOL_OFFLOAD_LIST OID verwenden, um die Protokollausladungen auflisten, die auf einem zugrunde liegenden Netzwerkadapter festgelegt sind. Nach einer erfolgreichen Rückgabe aus der OID-Abfrageanforderung enthält das InformationBuffer Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine Liste der NDIS_PM_PROTOCOL_OFFLOAD Strukturen, die die derzeit aktiven Protokollausladungen beschreiben.

Bemerkungen

NDIS behandelt die Abfrage für Miniporttreiber. NDIS-Treiber können die OID_PM_PROTOCOL_OFFLOAD_LIST OID verwenden, um eine Liste von Protokollausladungen abzurufen, die auf einem zugrunde liegenden Netzwerkadapter festgelegt sind.

Für jede NDIS_PM_PROTOCOL_OFFLOAD Struktur in der Liste legt NDIS den NextProtocolOffloadOffset Element auf den Offset vom Anfang des OID-Informationspuffers fest (d. h. den Anfang des Puffers, auf den der InformationBuffer Member der NDIS_OID_REQUEST Struktur verweist) auf den Anfang der nächsten NDIS_PM_PROTOCOL_OFFLOAD Struktur in der Liste. Der Offset im NextProtocolOffloadOffset Element der letzten Struktur in der Liste ist Null.

Wenn keine Protokoll-Offloads vorhanden sind, die auf dem Netzwerkadapter festgelegt sind, legt NDIS die DATA fest. QUERY_INFORMATION. BytesWritten Member der NDIS_OID_REQUEST-Struktur auf Null und gibt NDIS_STATUS_SUCCESS zurück. Die Daten innerhalb der DATA. QUERY_INFORMATION. InformationBuffer Mitglied wird von NDIS nicht geändert.

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

NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen. Die InformationBuffer- enthält einen Zeiger auf eine Liste von Protokoll-Offloads( falls vorhanden).

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

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_FAILURE
Die Anforderung ist aus anderen Gründen als den vorherigen Gründen fehlgeschlagen.

Anforderungen

Version

Unterstützt in NDIS 6.20 und höher. Für Miniporttreiber nicht angefordert. (Siehe Abschnitt "Hinweise".)

Kopfball

Ntddndis.h (include Ndis.h)

Siehe auch

NDIS_OID_REQUEST

NDIS_PM_PROTOCOL_OFFLOAD