NDIS_RECEIVE_FILTER_INFO_ARRAY 構造体 (ntddndis.h)

[アーティクル]
02/26/2024

NDIS_RECEIVE_FILTER_INFO_ARRAY構造体は、ミニポートドライバーで現在構成されている受信フィルターの一覧を指定します。

NDIS 受信フィルターは、次の NDIS インターフェイスで使用されます。

NDIS パケット結合。このインターフェイスで受信フィルターを使用する方法の詳細については、「パケット結合受信フィルターの管理」を参照してください。
単一ルート I/O 仮想化 (SR-IOV)。このインターフェイスで受信フィルターを使用する方法の詳細については、「仮想ポートでの受信フィルターの設定」を参照してください。
バーチャルマシンキュー (VMQ)。このインターフェイスで受信フィルターを使用する方法の詳細については、「 VMQ フィルターの設定とクリア」を参照してください。

構文

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;

メンバー

Header

NDIS_RECEIVE_FILTER_INFO_ARRAY構造体の型、リビジョン、およびサイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポートドライバーは、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_RECEIVE_FILTER_INFO_ARRAY構造体のバージョンを指定するには、ドライバーは Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2

NDIS 6.30 のメンバーを追加しました。

[サイズ] メンバーを [NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2] に設定します。

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1

NDIS 6.20 の元のバージョン。

[サイズ] メンバーをNDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1に設定します。

QueueId

受信キュー識別子。この識別子は、0 からネットワークアダプターがサポートするキューの数までの整数です。 NDIS_DEFAULT_RECEIVE_QUEUE_ID の値は、既定の受信キューを指定します。

メモNDIS パケット結合または SR-IOV インターフェイスをサポートするミニポートドライバーは、QueueId メンバーをNDIS_DEFAULT_RECEIVE_QUEUE_IDに設定する必要があります。

FirstElementOffset

この構造体に続く要素の配列内の最初の要素へのオフセット (バイト単位)。オフセットは、 NDIS_RECEIVE_FILTER_INFO_ARRAY 構造体の先頭から最初の要素の先頭まで測定されます。配列内の各要素は、NDIS_RECEIVE_FILTER_INFO 構造体です。

メモNumElements が 0 に設定されている場合、このメンバーは無視されます。

NumElements

配列の要素数。

ElementSize

配列の各要素のサイズ (バイト単位)。

Flags

次のフラグのビットごとの OR。

NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED

このフラグが設定されている場合、 VPortId メンバーによって指定された仮想ポート (VPort) で構成された受信フィルターに関する情報が要求されます。

メモこのフラグは、SR-IOV インターフェイスでのみ有効です。

VPortId

受信フィルターが照会されている仮想ポート (VPort) 識別子。 VPort 識別子は、次のいずれかの値である必要があります。

OID_NIC_SWITCH_CREATE_VPORT の OID メソッド要求を通じて以前に割り当てられた VPort の識別子。
NIC スイッチの既定の VPort を指定する NDIS_DEFAULT_VPORT_ID の値。

NIC スイッチは、SR-IOV インターフェイスのネットワークアダプターでサポートされています。 NIC スイッチは、1 つ以上の VPort を持つよう構成できます。

メモVPortId メンバーは、NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED フラグが Flags で設定されている場合にのみ有効です。

注釈

NDIS_RECEIVE_FILTER_INFO_ARRAY構造体は、OID_RECEIVE_FILTER_ENUM_FILTERSの OID 要求で使用されます。この OID 要求は、VMQ または SR-IOV 受信キューの受信フィルターを列挙します。 NDIS_RECEIVE_FILTER_INFO_ARRAY構造体に続く配列内の各要素は、 NDIS_RECEIVE_FILTER_INFO 構造体。