Freigeben über


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:

Bemerkungen

NDIS-Empfangsfilter werden in den folgenden NDIS-Schnittstellen verwendet:

Ü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

NDIS_OID_REQUEST

OID_RECEIVE_FILTER_ENUM_FILTERS

NDIS_RECEIVE_FILTER_PARAMETERS

OID_RECEIVE_FILTER_SET_FILTER