Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Überlastungstreiber stellen OID-Abfrageanforderungen von OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES aus, um die Empfangen von Filterhardwarefunktionen eines Netzwerkadapters abzurufen.
Nach einer erfolgreichen Rückgabe aus der OID-Abfrageanforderung enthält das InformationBuffer Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eineNDIS_RECEIVE_FILTER_CAPABILITIES Struktur.
Bemerkungen
NDIS-Empfangsfilter werden in den folgenden NDIS-Schnittstellen verwendet:
NDIS Packet Coalescing. Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Managing Packet Coalescing Receive Filters.
Single Root I/O Virtualization (SR-IOV). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Festlegen eines Empfangsfilters für einen virtuellen Port.
VMQ(Virtual Machine Queue). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Einstellung und Löschen von VMQ-Filtern.
Die NDIS_RECEIVE_FILTER_CAPABILITIES-Struktur enthält Informationen zu den Hardwarefunktionen für den Empfang von Filterhardware eines Netzwerkadapters. Diese Funktionen können Hardwarefunktionen enthalten, die derzeit von INF-Dateieinstellungen oder über die Seite Erweiterte eigenschaften deaktiviert sind.
Hinweis Alle Filterhardwarefunktionen eines Netzwerkadapters werden über eine OID-Abfrageanforderung von OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES zurückgegeben, unabhängig davon, ob eine Funktion aktiviert oder deaktiviert ist.
Ab NDIS 6.20 registrieren Miniporttreiber die derzeit aktivierten Filterhardwarefunktionen des Netzwerkadapters, wenn die MiniportInitializeEx- funktion aufgerufen wird. Miniport-Treiber registrieren diese Funktionen, indem Sie die folgenden Schritte ausführen:
Der Treiber initialisiert eine NDIS_RECEIVE_FILTER_CAPABILITIES Struktur mit den Hardwarefunktionen für den Empfang von Filterhardware.
Der Treiber initialisiert eine NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES Struktur und legt den CurrentReceiveFilterCapabilities Member auf einen Zeiger auf die NDIS_RECEIVE_FILTER_CAPABILITIES Struktur fest.
Der Miniporttreiber ruft die NdisMSetMiniportAttributes--Funktion auf und legt den MiniportAttributes Parameter auf einen Zeiger auf eine NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES Struktur fest.
Rückgabestatuscodes
NDIS behandelt die OID-Abfrageanforderung von OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES für Miniporttreiber und gibt einen der folgenden Statuscodes zurück:
NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen. Die InformationBuffer- verweist auf eine NDIS_RECEIVE_FILTER_CAPABILITIES Struktur.
NDIS_STATUS_PENDING
Die Anforderung steht aus. NDIS übergibt den endgültigen Statuscode und ergebnisse an den OID-Anforderungsabschlusshandler des Aufrufers, nachdem die Anforderung abgeschlossen wurde.
NDIS_STATUS_INVALID_LENGTH
Der Informationspuffer war zu kurz. NDIS legt die DATA fest. QUERY_INFORMATION. BytesNeededed Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.
NDIS_STATUS_NOT_SUPPORTED
Der Netzwerkadapter unterstützt keine Empfangsfilterung.
NDIS_STATUS_FAILURE
Fehler bei der Anforderung aus anderen Gründen.
Anforderungen
Version |
Unterstützt in NDIS 6.20 und höher. |
Kopfball |
Ntddndis.h (include Ndis.h) |