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 インターフェイスで使用されます。

上部のドライバーまたはアプリケーションは、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 インターフェイスの追加ガイドライン

上部のドライバーは、OID_RECEIVE_FILTER_ENUM_FILTERS の OID メソッド要求を発行して、VMQ 受信キューに設定された受信フィルターを列挙できます。 上部のドライバーは、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 は、NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。

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