Auf Englisch lesen

Freigeben über


OID_RECEIVE_FILTER_MOVE_FILTER

Ein überlagernder Treiber gibt eine OID-Set-Anforderung (Object Identifier) von OID_RECEIVE_FILTER_MOVE_FILTER aus, um einen zuvor konfigurierten Empfangsfilter zu verschieben. Empfangsfilter werden von einem virtuellen Port (VPort) auf einen anderen VPort verschoben.

Überlastende Treiber stellen diese OID-Set-Anforderung an den Miniporttreiber für die PCIe Physical Function (PF) des Netzwerkadapters aus. Diese Anforderung für den OID-Satz ist für PF-Miniporttreiber erforderlich, die die SINGLE-Root-E/A-Virtualisierungsschnittstelle (SR-IOV) unterstützen.

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS-Struktur .

Bemerkungen

NDIS überprüft die Member der NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS-Struktur , bevor die OID-Setanforderung an den PF-Miniporttreiber weitergeleitet wird.

Der PF-Miniporttreiber muss diese OID-Set-Anforderung atomar verarbeiten. Der Treiber muss in der Lage sein, den Netzwerkadapter so zu konfigurieren, dass der Filter gleichzeitig aus einer Empfangswarteschlange und einem VPort entfernt und auf eine andere Empfangswarteschlange und einen anderen VPort festgelegt wird.

Weitere Informationen finden Sie unter Verschieben eines Empfangsfilters in einen virtuellen Port.

Rückgabestatuscodes

Der PF-Miniporttreiber gibt einen der folgenden status-Codes für die OID-Satzanforderung von OID_RECEIVE_FILTER_MOVE_FILTER zurück.

Statuscode BESCHREIBUNG

NDIS_STATUS_SUCCESS

Die OID-Anforderung wurde erfolgreich abgeschlossen.

NDIS_STATUS_NOT_SUPPORTED

Der PF-Miniporttreiber unterstützt entweder nicht die SR-IOV-Schnittstelle (Single Root E/O Virtualization) oder ist für die Verwendung der Schnittstelle nicht aktiviert.

NDIS_STATUS_INVALID_PARAMETER

Mindestens ein Member der NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS-Struktur weisen ungültige Werte auf.

NDIS_STATUS_INVALID_LENGTH

Die Länge des Informationspuffers ist kleiner als sizeof(NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS). Der PF-Miniporttreiber muss die DATA festlegen. 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.

Requirements (Anforderungen)

Version

Unterstützt in NDIS 6.30 und höher.

Header

Ntddndis.h (include Ndis.h)

Weitere Informationen


NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS