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.
Ein übermäßiger Treiber gibt eine OID-Methodenanforderung von OID_RECEIVE_FILTER_PARAMETERS aus, um die aktuellen Konfigurationsparameter eines Filters auf einem Netzwerkadapter abzurufen.
Das InformationBuffer-element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_RECEIVE_FILTER_PARAMETERS Struktur. NDIS verwendet das FilterId Member in der Eingabestruktur, um den Filter zu identifizieren.
Nach einer erfolgreichen Rückgabe aus der OID-Methodenanforderung enthält das InformationBuffer Member der NDIS_OID_REQUEST-Struktur einen Zeiger auf einen Puffer. Dieser Puffer ist so formatiert, dass er Folgendes enthält:
Eine NDIS_RECEIVE_FILTER_PARAMETERS Struktur, die die Parameter für einen NDIS-Empfangsfilter angibt.
Ein Array von NDIS_RECEIVE_FILTER_FIELD_PARAMETERS Strukturen, die das Filtertestkriterium für ein Feld in einem Netzwerkpaketheader angibt.
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.
Überlastungstreiber geben Anforderungen der OID-Methode von OID_RECEIVE_FILTER_PARAMETERS aus, um die Konfigurationsparameter für einen Empfangenfilter abzurufen, der auf einem Netzwerkadapter festgelegt wurde. Dies umfasst einen Empfangenfilter, der für eine VMQ-Empfangswarteschlange oder SR-IOV virtuellen Port (VPort) festgelegt wurde, sowie einen Paket-Koppierungsfilter, der auf den Miniporttreiber heruntergeladen wurde.
Der übersteigende Treiber hat den Filterbezeichner aus einer früheren OID-Methodenanforderung von OID_RECEIVE_FILTER_SET_FILTER oder von OID-Anforderungen von OID_RECEIVE_FILTER_ENUM_FILTERSabgerufen.
Rückgabestatuscodes
NDIS verarbeitet die OID-Anforderung von OID_RECEIVE_FILTER_PARAMETERS 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_PARAMETERS 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_PARAMETER
Der überfällige Treiber oder die Anwendung hat einen ungültigen Filterbezeichner bereitgestellt. Ein Filterbezeichner ist ungültig, wenn er null ist oder einen nicht definierten Filter angibt.
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_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) |
Siehe auch
OID_RECEIVE_FILTER_ENUM_FILTERS