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 構造体として書式設定されます。
ミニポート ドライバーは、ヘッダー の 型 メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_RECEIVE_FILTER_INFO_ARRAY 構造体のバージョンを指定するには、ドライバーは、ヘッダー の リビジョン メンバーを次の値に設定する必要があります。
NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2
NDIS 6.30 のメンバーを追加しました。
Size メンバーを NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2 に設定します。
NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1
NDIS 6.20 の元のバージョン。
Size メンバーをNDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1に設定します。
QueueId
受信キュー識別子。 この識別子は、0 からネットワーク アダプターがサポートするキューの数までの整数です。 NDIS_DEFAULT_RECEIVE_QUEUE_IDの値は、既定の受信キューを指定します。
FirstElementOffset
この構造体に続く要素の配列内の最初の要素へのオフセット (バイト単位)。 オフセットは、NDIS_RECEIVE_FILTER_INFO_ARRAY 構造体の先頭から最初の要素の先頭まで測定されます。 配列内の各要素は、NDIS_RECEIVE_FILTER_INFO 構造体です。
NumElements
配列内の要素の数。
ElementSize
配列内の各要素のサイズ (バイト単位)。
Flags
次のフラグのビットごとの OR。
NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED
このフラグを設定すると、VPortId メンバーによって指定された仮想ポート (VPort) で構成されている受信フィルターに関する情報が要求されます。
VPortId
受信フィルターが照会されている仮想ポート (VPort) 識別子。 VPort 識別子は、次のいずれかの値である必要があります。
-
OID_NIC_SWITCH_CREATE_VPORTの OID メソッド要求を通じて以前に割り当てられた VPort の識別子。
- NIC スイッチの既定の VPort を指定するNDIS_DEFAULT_VPORT_IDの値。
備考
NDIS_RECEIVE_FILTER_INFO_ARRAY 構造体は、 OID_RECEIVE_FILTER_ENUM_FILTERSの OID 要求で使用されます。 この OID 要求は、VMQ または受信キューの受信フィルター SR-IOV 列挙します。 NDIS_RECEIVE_FILTER_INFO_ARRAY 構造体の後に続く配列内の各要素は、 NDIS_RECEIVE_FILTER_INFO 構造体。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | NDIS 6.20 以降でサポートされています。 |
ヘッダー | ntddndis.h (Ndis.h を含む) |