NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur (ntddndis.h)

Artikel
02/26/2024

Die NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur gibt eine Liste der Empfangsfilter an, die derzeit für einen Miniporttreiber konfiguriert sind.

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_ARRAY {
  NDIS_OBJECT_HEADER       Header;
  NDIS_RECEIVE_QUEUE_ID    QueueId;
  ULONG                    FirstElementOffset;
  ULONG                    NumElements;
  ULONG                    ElementSize;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NDIS_RECEIVE_FILTER_INFO_ARRAY, *PNDIS_RECEIVE_FILTER_INFO_ARRAY;

Member

Header

Typ, Revision und Größe der NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur . Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss das Type-Element von Header auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur anzugeben, muss der Treiber den Revisionsmember von Header auf den folgenden Wert festlegen:

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2

Member für NDIS 6.30 hinzugefügt.

Legen Sie das Element Größe auf NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2 fest.

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1

Originalversion für NDIS 6.20.

Legen Sie das Element Größe auf NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1 fest.

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 SR-IOV-Schnittstelle unterstützen, müssen das QueueId-Element auf NDIS_DEFAULT_RECEIVE_QUEUE_ID festlegen.

FirstElementOffset

Der Offset in Bytes für das erste Element in einem Array von Elementen, die dieser Struktur folgen. Der Offset wird vom Anfang der NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur bis zum Anfang des ersten Elements gemessen. Jedes Element im Array ist eine NDIS_RECEIVE_FILTER_INFO-Struktur .

Hinweis Wenn NumElements auf 0 festgelegt ist, wird dieser Member ignoriert.

NumElements

Die Anzahl der Elemente im Array.

ElementSize

Die Größe jedes Elements im Array in Bytes.

Flags

Ein bitweises OR der folgenden Flags:

NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED

Wenn dieses Flag festgelegt ist, werden Informationen zu Empfangsfiltern angefordert, die für den vom VPortId-Member angegebenen virtuellen Port (VPort) konfiguriert sind.

Hinweis Dieses Flag ist nur für die SR-IOV-Schnittstelle gültig.

VPortId

Der VPort-Bezeichner (Virtual Port), für den Empfangsfilter abgefragt werden. Der VPort-Bezeichner muss einer der folgenden Werte sein:

Der Bezeichner eines VPorts, der zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT zugeordnet wurde.
Ein Wert von NDIS_DEFAULT_VPORT_ID, der den Standard-VPort auf dem NIC-Switch angibt.

Ein NIC-Switch wird von Netzwerkadaptern für die SR-IOV-Schnittstelle unterstützt. Der NIC-Switch kann mit einem oder mehreren VPorts konfiguriert werden.

Hinweis Das VPortId-Element ist nur gültig, wenn das flag NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED in Flags festgelegt ist.

Hinweise

Die NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur wird in der OID-Anforderung von OID_RECEIVE_FILTER_ENUM_FILTERS verwendet. Diese OID-Anforderung listet die Empfangsfilter in einer VMQ- oder SR-IOV-Empfangswarteschlange auf. Jedes Element im Array, das der NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur folgt, ist ein NDIS_RECEIVE_FILTER_INFO Struktur.