NDIS_NET_BUFFER_LIST_FILTERING_INFO-Struktur (ndis.h)

Artikel
11/28/2023

Die NDIS_NET_BUFFER_LIST_FILTERING_INFO-Struktur definiert Filterinformationen, die einer NET_BUFFER_LIST-Struktur zugeordnet sind.

Syntax

typedef struct _NDIS_NET_BUFFER_LIST_FILTERING_INFO {
  union {
    struct {
      USHORT FilterId;
      union {
        USHORT QueueId;
        USHORT VPortId;
      } QueueVPortInfo;
    } FilteringInfo;
    PVOID Value;
  };
} NDIS_NET_BUFFER_LIST_FILTERING_INFO, *PNDIS_NET_BUFFER_LIST_FILTERING_INFO;

Member

FilteringInfo

Eine Struktur, die die folgenden Member enthält:

FilteringInfo.FilterId

Ein USHORT-Wert, der einen Empfangsfilterbezeichner enthält. Der Empfangsfilterbezeichner ist eine ganze Zahl von 1 bis zur Anzahl von Empfangsfiltern, die der Netzwerkadapter unterstützt.

Hinweis Ab NDIS 6.20 muss dieser Member auf 0 festgelegt werden.

FilteringInfo.QueueVPortInfo

Eine Union, die die folgenden Elemente enthält:

FilteringInfo.QueueVPortInfo.QueueId

Ein USHORT-Wert, der einen Bezeichner für eine VMQ-Empfangswarteschlange enthält. Der Warteschlangenbezeichner 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 Ab Windows Server 2012 muss der Wert dieses Members von Miniporttreibern, die die SR-IOV-Schnittstelle unterstützen, immer auf NDIS_DEFAULT_RECEIVE_QUEUE_ID festgelegt werden.

FilteringInfo.QueueVPortInfo.VPortId

Ein USHORT-Wert, der den Bezeichner für einen virtuellen Port (VPort) enthält. Der Wert NDIS_DEFAULT_VPORT_ID den Standard-VPort für den NIC-Switch angibt.

Der VPort mit dem angegebenen VPortId-Wert muss zuvor über eine Bestimmte Anforderung von OID_NIC_SWITCH_CREATE_VPORT erstellt worden sein.

Hinweis Für die VMQ-Schnittstelle muss dieser Member auf NDIS_DEFAULT_VPORT_ID festgelegt werden.

Value

Ein PVOID-Typwert, der sich in einer Union mit dem FilteringInfo-Element befindet. Mit diesem Element kann ein Treiber auf alle Informationen in der NDIS_NET_BUFFER_LIST_FILTERING_INFO-Struktur als einen PVOID-Wert zugreifen.

Hinweise

Ab NDIS 6.20 verwenden Miniporttreiber die NDIS_NET_BUFFER_LIST_FILTERING_INFO-Struktur , um Empfangsfilterinformationen anzugeben, die die NET_BUFFER Strukturen begleiten, die einer NET_BUFFER_LIST Struktur zugeordnet sind.

Um über die NET_BUFFER_LIST OOB-Daten auf die NDIS_NET_BUFFER_LIST_FILTERING_INFO-Struktur zuzugreifen, ruft ein NDIS-Treiber das makro NET_BUFFER_LIST_INFO auf und gibt den Informationstyp NetBufferListFilteringInfo an.

Um direkt auf die Bezeichnerwerte zuzugreifen, verwenden Sie die NET_BUFFER_LIST_RECEIVE_FILTER_ID, NET_BUFFER_LIST_RECEIVE_FILTER_VPORT_ID oder NET_BUFFER_LIST_RECEIVE_QUEUE_ID Makros.