OID_RECEIVE_FILTER_CLEAR_FILTER

上部のドライバーは、OID_RECEIVE_FILTER_CLEAR_FILTER の OID セット要求を発行して、ネットワーク アダプターの受信フィルターをクリアします。

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

解説

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

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

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

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

NDIS パケット結合、SR-IOV、または VMQ インターフェイスをサポートするミニポート ドライバーには、OID_RECEIVE_FILTER_CLEAR_FILTER の OID セット要求が必須です。

上部のドライバー (NDIS プロトコルやフィルター ドライバーなど) は、OID_RECEIVE_FILTER_CLEAR_FILTER セット要求を使用して、以前に設定されたフィルターをクリアします。 受信フィルターを設定したドライバーのみがクリアできます。

上部のドライバーは、NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS 構造体の FilterId メンバーをフィルターの識別子に設定することによって、受信フィルターをクリアします。 ドライバーは、OID_RECEIVE_FILTER_SET_FILTER の以前の OID メソッド要求からフィルター識別子を取得しています。

NDIS パケット結合の追加手順

次のポイントは、NDIS パケット結合をサポートするミニポートおよび上部のドライバーに適用されます。

• 上部のドライバーは、ドライバーのバインドを解除するか、デタッチする前に、ミニポート ドライバーに設定されているすべての受信フィルターをクリアする必要があります。

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

SR-IOV インターフェイスをサポートするミニポート ドライバーと上部のドライバーには、次の点が適用されます。

• 上部のドライバーは、VPort を解放する前に、SR-IOV VPort に設定されているすべてのフィルターをクリアする必要があります。 また、上部のドライバーは、ネットワーク アダプターへのバインディングを終了する前に、既定の VPort に設定されているすべてのフィルターをクリアする必要があります。

• ミニポート ドライバーは、OID_RECEIVE_FILTER_CLEAR_FILTER の OID 要求を完了し、VPort の最後のフィルターをクリアしている場合、既定以外の VPort 上のパケットを示すことはできません。

  注 ミニポート ドライバーは、OID_NIC_SWITCH_DELETE_VPORT の OID 要求を完了し、VPort を解放している場合も、既定以外の VPort 上のパケットを示すことはできません。

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

VMQ インターフェイスをサポートするミニポート ドライバーと上部のドライバーには、次の点が適用されます。

• 上部のドライバーは、キューを解放する前に、VMQ 受信キューに設定されているすべてのフィルターをクリアする必要があります。 また、上部のドライバーは、ネットワーク アダプターへのバインディングを終了する前に、既定のキューまたはドロップ キューに設定されているすべてのフィルターをクリアする必要があります。

• ミニポート ドライバーは、OID_RECEIVE_FILTER_CLEAR_FILTER の OID 要求を完了し、受信キューの最後のフィルターをクリアしている場合、受信キュー上のパケットを示すことはできません。

  注 ミニポート ドライバーは、OID_RECEIVE_FILTER_FREE_QUEUE の OID 要求を完了し、受信キューを解放した場合も、受信キュー上のパケットを示すことはできません。

状態コードを返す

ミニポート ドライバーの MiniportOidRequest 関数は、この要求に対して次のいずれかの値を返します。

NDIS は、この要求に対して次のいずれかの状態コードを返します。

NDIS_STATUS_SUCCESS
指定したフィルターが正常にクリアされました。

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

NDIS_STATUS_FILE_NOT_FOUND
フィルター識別子が有効ではありません。

NDIS_STATUS_INVALID_LENGTH
情報バッファーが小さすぎます。 NDIS は、 NDIS_OID_REQUEST 構造体の DATA.SET_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。

要件

関連項目

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS

OID_NIC_SWITCH_DELETE_VPORT

OID_RECEIVE_FILTER_FREE_QUEUE

OID_RECEIVE_FILTER_SET_FILTER