NDIS_NET_BUFFER_LIST_FILTERING_INFO構造体 (ndis.h)

[アーティクル]
03/05/2024

NDIS_NET_BUFFER_LIST_FILTERING_INFO構造体は、NET_BUFFER_LIST構造体に関連付けられているフィルター処理情報を定義します。

構文

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;

メンバー

FilteringInfo

次のメンバーを含む構造体。

FilteringInfo.FilterId

受信フィルター識別子を含む USHORT 値。受信フィルター識別子は、1 からネットワークアダプターがサポートする受信フィルターの数までの整数です。

メモ NDIS 6.20 以降では、このメンバーを 0 に設定する必要があります。

FilteringInfo.QueueVPortInfo

次のメンバーを含む共用体。

FilteringInfo.QueueVPortInfo.QueueId

仮想マシンキュー (VMQ) 受信キューの識別子を含む USHORT 値。キュー識別子は、0 からネットワークアダプターがサポートするキューの数までの整数です。 NDIS_DEFAULT_RECEIVE_QUEUE_ID の値は、既定の受信キューを指定します。

メモWindows Server 2012以降、このメンバーの値は、SR-IOV インターフェイスをサポートするミニポートドライバーによって常にNDIS_DEFAULT_RECEIVE_QUEUE_IDに設定する必要があります。

FilteringInfo.QueueVPortInfo.VPortId

仮想ポート (VPort) の識別子を含む USHORT 値。 NDIS_DEFAULT_VPORT_ID の値は、NIC スイッチの既定の VPort を指定します。

指定された VPortId 値を持つ VPort は、 OID_NIC_SWITCH_CREATE_VPORTのセット要求によって以前に作成されている必要があります。

メモ VMQ インターフェイスの場合、このメンバーを NDIS_DEFAULT_VPORT_ID に設定する必要があります。

Value

FilteringInfo メンバーとの共用体内にある PVOID 型の値。このメンバーを使用すると、ドライバーは 、NDIS_NET_BUFFER_LIST_FILTERING_INFO 構造体内のすべての情報に 1 つの PVOID 値としてアクセスできます。

注釈

NDIS 6.20 以降、ミニポートドライバーは 、NDIS_NET_BUFFER_LIST_FILTERING_INFO 構造体を使用して、NET_BUFFER_LIST構造体に関連付けられている NET_BUFFER 構造体に付随する受信フィルター情報を指定します。

NET_BUFFER_LIST OOB データから NDIS_NET_BUFFER_LIST_FILTERING_INFO 構造体にアクセスするには、NDIS ドライバーは、NET_BUFFER_LIST_INFO マクロを呼び出し、 NetBufferListFilteringInfo 情報の種類を指定します。

識別子の値に直接アクセスするには、 NET_BUFFER_LIST_RECEIVE_FILTER_ID、 NET_BUFFER_LIST_RECEIVE_FILTER_VPORT_ID、またはマクロをNET_BUFFER_LIST_RECEIVE_QUEUE_ID します。