OID_PM_PROTOCOL_OFFLOAD_LIST
Als Abfrage können übergeordnete Treiber die OID_PM_PROTOCOL_OFFLOAD_LIST OID verwenden, um die Protokollauslagerungen aufzulisten, die auf einem zugrunde liegenden Netzwerkadapter festgelegt sind. Nach einer erfolgreichen Rückgabe von der OID-Abfrageanforderung enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine Liste von NDIS_PM_PROTOCOL_OFFLOAD Strukturen, die die derzeit aktiven Protokollauslagerungen beschreiben.
Bemerkungen
NDIS verarbeitet die Abfrage für Miniporttreiber. NDIS-Treiber können die OID_PM_PROTOCOL_OFFLOAD_LIST OID verwenden, um eine Liste der Protokollauslagerungen abzurufen, die auf einem zugrunde liegenden Netzwerkadapter festgelegt sind.
Für jede NDIS_PM_PROTOCOL_OFFLOAD Struktur in der Liste legt NDIS den NextProtocolOffloadOffset-Member auf den Offset vom Anfang des OID-Informationspuffers (d. h. dem Anfang des Puffers, auf den das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur zeigt) bis zum Anfang der nächsten NDIS_PM_PROTOCOL_OFFLOAD-Struktur in der Liste fest. Der Offset im NextProtocolOffloadOffset-Element der letzten Struktur in der Liste ist null.
Wenn auf dem Netzwerkadapter keine Protokollauslagerungen festgelegt sind, legt NDIS die DATEN fest. QUERY_INFORMATION. BytesWritten-Member der NDIS_OID_REQUEST-Struktur auf 0 (null) und gibt NDIS_STATUS_SUCCESS zurück. Die Daten in den DATEN. QUERY_INFORMATION. Das InformationBuffer-Element wird von NDIS nicht geändert.
NDIS gibt einen der folgenden status Codes für die Anforderung zurück:
NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen. Der InformationBuffer enthält einen Zeiger auf eine Liste von Protokollauslagerungen, falls vorhanden.
NDIS_STATUS_PENDING
Die Anforderung steht noch aus. Der endgültige status Code und die Ergebnisse werden an den OID-Anforderungsabschlusshandler des Aufrufers übergeben.
NDIS_STATUS_BUFFER_TOO_SHORT
Der Informationspuffer war zu kurz. NDIS legt die DATEN 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 oben genannten Gründen fehlgeschlagen.
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.20 und höher. Für Miniporttreiber nicht angefordert. (Siehe Abschnitt Hinweise.) |
Header |
Ntddndis.h (include Ndis.h) |