OID_RECEIVE_FILTER_PARAMETERS
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 den FilterId-Member in der Eingabestruktur, um den Filter zu identifizieren.
Nach einer erfolgreichen Rückgabe von der OID-Methodenanforderung enthält der 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, das 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.For more information about how to use receive filters in this interface, see Managing Packet Coalescing Receive Filters.
Single Root E/O Virtualization (SR-IOV). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Festlegen eines Empfangsfilters für einen virtuellen Port.
Virtual Machine Queue (VMQ). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Festlegen und Löschen von VMQ-Filtern.
Überlastende Treiber geben OID-Methodenanforderungen von OID_RECEIVE_FILTER_PARAMETERS aus, um die Konfigurationsparameter für einen Empfangsfilter abzurufen, der auf einem Netzwerkadapter festgelegt wurde. Dies umfasst einen Empfangsfilter, der für eine VMQ-Empfangswarteschlange oder einen virtuellen SR-IOV-Port (VPort) festgelegt wurde, sowie einen Paketverknappungsfilter, der auf den Miniporttreiber heruntergeladen wurde.
Der überlastende Treiber hat den Filterbezeichner aus einer früheren OID-Methodenanforderung von OID_RECEIVE_FILTER_SET_FILTER oder aus OID-Anforderungen von OID_RECEIVE_FILTER_ENUM_FILTERS abgerufen.
Zurückgeben von status Codes
NDIS verarbeitet die OID-Anforderung von OID_RECEIVE_FILTER_PARAMETERS für Miniporttreiber und gibt einen der folgenden status Codes zurück:
NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen. Der InformationBuffer verweist auf eine NDIS_RECEIVE_FILTER_PARAMETERS-Struktur .
NDIS_STATUS_PENDING
Die Anforderung steht noch aus. NDIS übergibt den endgültigen status Code und die Ergebnisse an den OID-Anforderungsabschlusshandler des Aufrufers, nachdem die Anforderung abgeschlossen ist.
NDIS_STATUS_INVALID_PARAMETER
Der überlastende 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 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 fehlgeschlagen.
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.20 und höher. |
Header |
Ntddndis.h (include Ndis.h) |
Weitere Informationen
OID_RECEIVE_FILTER_ENUM_FILTERS