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) |