NDIS_RECEIVE_FILTER_INFO-Struktur (ntddndis.h)

Artikel
03/01/2024

Die NDIS_RECEIVE_FILTER_INFO-Struktur enthält Informationen zu einem Empfangsfilter, der derzeit für einen Miniporttreiber konfiguriert ist.

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.

Syntax

typedef struct _NDIS_RECEIVE_FILTER_INFO {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_RECEIVE_FILTER_TYPE FilterType;
  NDIS_RECEIVE_FILTER_ID   FilterId;
} NDIS_RECEIVE_FILTER_INFO, *PNDIS_RECEIVE_FILTER_INFO;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_RECEIVE_FILTER_INFO-Struktur . Der Treiber legt den Typmember der Struktur fest, die Header angibt, um NDIS_OBJECT_TYPE_DEFAULT.

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

NDIS_RECEIVE_FILTER_INFO_REVISION_1

Originalversion für NDIS 6.20.

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

Flags

Ein bitweises OR mit Flags. Dieser Member ist für NDIS reserviert.

FilterType

Der Typ des Empfangsfilters.

FilterId

Ein Empfangsfilterbezeichner. Der Filterbezeichner ist eine ganze Zahl von 1 bis einschließlich der Anzahl von Empfangsfiltern, die der Netzwerkadapter unterstützt. Der Wert 0 (null) ist ungültig.

Hinweise

Die NDIS_RECEIVE_FILTER_INFO-Struktur wird mit der NDIS_RECEIVE_FILTER_INFO_ARRAY Struktur für die OID-Anforderung von OID_RECEIVE_FILTER_ENUM_FILTERS. Diese OID-Anforderung listet Empfangsfilter auf, die für den Miniporttreiber konfiguriert wurden. Dies schließt die Paketverknen von Empfangsfiltern oder die Empfangsfilter ein, die in einer Empfangswarteschlange konfiguriert sind, die in der VMQ- oder SR-IOV-Schnittstelle verwendet wird.