OID_PACKET_COALESCING_FILTER_MATCH_COUNT

Artikel
06/15/2023

NDIS gibt eine OID-Abfrageanforderung von OID_PACKET_COALESCING_FILTER_MATCH_COUNT aus, um die Anzahl der Pakete abzurufen, die auf dem Netzwerkadapter zwischengespeichert oder zusammengelöst wurden. Der Netzwerkadapter vereint empfangene Pakete, wenn der Adapter für die NDIS-Paketverknappung aktiviert ist und das Paket mit einem Empfangsfilter übereinstimmt.

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine vom Aufrufer zugewiesene ULONG64-Variable. Bevor die Abfrageanforderung erfolgreich zurückgegeben wird, aktualisiert der Treiber die ULONG64-Variable mit der Anzahl von Paketen, die den Empfangsfiltern des Netzwerkadapters entsprechen.

Bemerkungen

Ab NDIS 6.30 müssen Treiber, die die NDIS-Paketkopplung unterstützen, OID-Abfrageanforderungen von OID_PACKET_COALESCING_FILTER_MATCH_COUNT unterstützen.

Hinweis Treiber, die die Single-Root-E/A-Virtualisierung (SR-IOV) oder VMQ-Schnittstellen (VMQ) unterstützen, sind nicht erforderlich, um OID-Abfrageanforderungen dieser OID zu unterstützen.

Ein Miniporttreiber, der die Paketverknappung unterstützt, muss einen ULONG64-Zähler für jedes empfangene Paket erhöhen, das auf dem Netzwerkadapter koalesciert wurde. Pakete werden zusammengeglichen, wenn sie mit einem Empfangsfilter übereinstimmen, der von überladenen Treibern über OID-Methodenanforderungen von OID_RECEIVE_FILTER_SET_FILTER auf den Miniporttreiber heruntergeladen wird.

Der Treiber gibt den Wert dieses Leistungsindikators zurück, wenn er eine OID-Abfrageanforderung von OID_PACKET_COALESCING_FILTER_MATCH_COUNT verarbeitet.

Der Miniporttreiber darf den Zähler nicht löschen, nachdem er die OID-Abfrageanforderung von OID_PACKET_COALESCING_FILTER_MATCH_COUNT verarbeitet hat. Der Miniporttreiber darf den Zähler nur löschen, wenn die folgenden Bedingungen zutreffen:

Der Miniporttreiber verarbeitet eine OID-Set-Anforderung von OID_PNP_SET_POWER , um den Status NdisDeviceStateD0 mit voller Leistung fortzusetzen.
NDIS ruft die MiniportResetEx-Funktion des Miniporttreibers auf, um den zugrunde liegenden Netzwerkadapter zurückzusetzen.

Weitere Informationen zum Paket-Koalescing finden Sie unter NDIS Packet Coalescing.

Zurückgeben status Codes

Der Miniporttreiber gibt einen der folgenden status Codes für die OID-Methodenanforderung von OID_PACKET_COALESCING_FILTER_MATCH_COUNT zurück:

NDIS_STATUS_SUCCESS
Die OID-Anforderung wurde erfolgreich abgeschlossen.

NDIS_STATUS_INVALID_LENGTH
Der Informationspuffer war zu kurz. Der Treiber legt die DATEN fest. SET_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_FAILURE
Die Anforderung ist aus anderen Gründen fehlgeschlagen.