NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS-Struktur (ntddndis.h)

Artikel
02/26/2024

Die NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS-Struktur gibt die Parameter an, um einen Empfangsfilter für einen Netzwerkadapter zu löschen.

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-E/A-Virtualisierung (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.

Syntax

typedef struct _NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_RECEIVE_QUEUE_ID  QueueId;
  NDIS_RECEIVE_FILTER_ID FilterId;
} NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS, *PNDIS_RECEIVE_FILTER_CLEAR_PARAMETERS;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS-Struktur . Der Treiber legt das Typelement der Struktur, die Header angibt, auf NDIS_OBJECT_TYPE_DEFAULT fest.

Um die Version der NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS-Struktur anzugeben, legt der Treiber den Revisionsmember auf einen der folgenden Werte fest:

NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS_REVISION_1

Ursprüngliche Version für NDIS 6.20.

Der Treiber legt das Element Größe auf NDIS_SIZEOF_RECEIVE_FILTER_CLEAR_PARAMETERS_REVISION_1 fest.

Flags

Ein bitweises OR von Flags. Dieses Element ist für NDIS reserviert.

QueueId

Ein Empfangswarteschlangenbezeichner. Dieser Bezeichner ist eine ganze Zahl zwischen null und der Anzahl von Warteschlangen, die der Netzwerkadapter unterstützt. Der Wert NDIS_DEFAULT_RECEIVE_QUEUE_ID gibt die Standard-Empfangswarteschlange an.

Hinweis Miniporttreiber, die die NDIS-Paketkopplung oder die SR-IOV-Schnittstelle unterstützen, müssen den QueueId-Member auf NDIS_DEFAULT_RECEIVE_QUEUE_ID festlegen.

FilterId

Ein Empfangsfilterbezeichner. Der Filterbezeichner ist eine ganze Zahl von 1 bis zur Anzahl von Empfangsfiltern, die der Netzwerkadapter unterstützt. Ein Wert von null ist ungültig.

Hinweise

Die NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS-Struktur wird mit OID-Anforderungen von
OID_RECEIVE_FILTER_CLEAR_FILTER , um einen Filter anzugeben, der für eine VMQ- oder SR-IOV-VPort-Empfangswarteschlange gelöscht werden soll. Der Filter wurde zuvor für die Warteschlange mit dem OID_RECEIVE_FILTER_SET_FILTER OID.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.20 und höher.
Kopfzeile	ntddndis.h (include Ndis.h)

Weitere Informationen

NDIS_OBJECT_HEADER

OID_RECEIVE_FILTER_CLEAR_FILTER

OID_RECEIVE_FILTER_SET_FILTER