OID_RECEIVE_FILTER_ENUM_FILTERS

基になるドライバーは、ネットワーク アダプターで構成されているすべてのフィルターの一覧を取得するOID_RECEIVE_FILTER_ENUM_FILTERSの OID メソッド要求を発行します。

NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_RECEIVE_FILTER_INFO_ARRAY 構造体へのポインターが含まれています。

OID メソッド要求から正常に戻った後、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーにはバッファーへのポインターが含まれます。 このバッファーは、次のように書式設定されます。

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

• NDIS_RECEIVE_FILTER_INFO 構造体の配列。 各構造体は、ミニポート ドライバーで現在構成されている受信フィルターのパラメーターを指定します。

備考

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

• NDIS パケット結合。 このインターフェイスで受信フィルターを使用する方法の詳細については、「パケット結合受信フィルターの管理を参照してください。

• シングル ルート I/O 仮想化 (SR-IOV)。 このインターフェイスで受信フィルターを使用する方法の詳細については、「仮想ポート で受信フィルターを設定するを参照してください。

• 仮想マシン キュー (VMQ) をします。 このインターフェイスで受信フィルターを使用する方法の詳細については、「VMQ フィルターの設定とクリア」を参照してください。

上にあるドライバーまたはアプリケーションは、ネットワーク アダプターに設定された受信フィルターを列挙するOID_RECEIVE_FILTER_ENUM_FILTERSの OID メソッド要求を発行します。 これには、SR-IOV 仮想ポート (VPort) または VMQ 受信キューに設定された受信フィルターが含まれます。

NDIS パケット結合インターフェイスの追加ガイドライン

Windows Server 2012 以降では、NDIS パケット結合では、ネットワーク アダプターの既定の受信キューのみがサポートされます。

パケット結合受信フィルターを列挙するには、上にあるドライバーは、NDIS_RECEIVE_FILTER_INFO_ARRAY 構造体の QueueId メンバーをNDIS_DEFAULT_RECEIVE_QUEUE_IDに設定する必要があります。

SR-IOV インターフェイスの追加ガイドライン

Windows Server 2012 以降では、SR-IOV インターフェイスは仮想ポート (VPort) の既定の受信キューのみをサポートします。

VPort 受信フィルターを列挙するには、NDIS_RECEIVE_FILTER_INFO_ARRAY 構造体のメンバー QueueId をNDIS_DEFAULT_RECEIVE_QUEUE_IDに設定する必要があります。

VMQ インターフェイスの追加ガイドライン

基になるドライバーは、VMQ 受信キューに設定された受信フィルターを列挙するOID_RECEIVE_FILTER_ENUM_FILTERSの OID メソッド要求を発行できます。 上にあるドライバーは、NDIS_RECEIVE_FILTER_INFO_ARRAY 構造体を初期化するときに、QueueId メンバーを次のいずれかの値に設定します。

• 既定以外の受信キューのキュー識別子の値。 上にあるドライバーは、OID_RECEIVE_FILTER_ALLOCATE_QUEUE の以前の OID メソッド要求または OID_RECEIVE_FILTER_ENUM_QUEUESの OID クエリ要求からキュー識別子の入力値を取得しました。

• 既定の受信キューを指定するNDIS_DEFAULT_RECEIVE_QUEUE_IDのキュー識別子の値。

戻り値の状態コード

NDIS は、ミニポート ドライバーのOID_RECEIVE_FILTER_ENUM_FILTERSの OID メソッド要求を処理し、次のいずれかの状態コードを返します。

NDIS_STATUS_SUCCESS
要求が正常に完了しました。 InformationBuffer は、NDIS_RECEIVE_FILTER_INFO_ARRAY 構造体を指します。

NDIS_STATUS_PENDING
要求の完了が保留中です。 NDIS は、要求が完了した後、呼び出し元の OID 要求完了ハンドラーに最終的な状態コードと結果を渡します。

NDIS_STATUS_INVALID_LENGTH
情報バッファーが短すぎます。 NDIS は、データを設定します。QUERY_INFORMATION。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。

NDIS_STATUS_FAILURE
その他の理由で要求が失敗しました。

必要条件

バージョン	NDIS 6.20 以降でサポートされています。
ヘッダ	Ntddndis.h (Ndis.h を含む)

関連項目

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_INFO

NDIS_RECEIVE_FILTER_INFO_ARRAY

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_ENUM_QUEUES

OID_RECEIVE_FILTER_SET_FILTER