OID_RECEIVE_FILTER_MOVE_FILTER
上位ドライバーは、以前に設定された受信フィルターを移動するために、OID_RECEIVE_FILTER_MOVE_FILTER のオブジェクト識別子 (OID) セット要求を発行します。 受信フィルターは、1 つの仮想ポート (VPort) から別の VPort に移動されます。
上位ドライバーは、ネットワークアダプターの PCIe 物理関数 (PF) 用ミニポートドライバーにこの OID セット要求を発行します。 この OID セット要求は、シングルルート I/O 仮想化 (SR-IOV) インターフェースをサポートする PF ミニポートドライバーに必要なものです。
この NDIS_OID_REQUEST 構造体の InformationBuffer メンバーは、 NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS 構造体へのポインターを含みます。
解説
NDIS は、PF ミニポート ドライバーに OID セット要求を転送する前に、 NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS 構造体のメンバーを検証します。
PF ミニポートドライバーは、この OID セット要求を自動的に処理する必要があります。 ドライバーは、受信キューと VPort からフィルターを同時に削除し、別の受信キューと VPort に設定するようにネットワーク アダプターを構成できる必要があります。
詳細については、 受信フィルターを仮想ポートに移動するを参照してください。
状態コードを返します
PF ミニポートドライバーは、OID_RECEIVE_FILTER_MOVE_FILTER の OID セット要求に対して、次の状態コードのいずれかを返します。
| 状態コード | 説明 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求は正常に完了しました。 |
NDIS_STATUS_NOT_SUPPORTED |
ミニポート ドライバーは、シングル ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートしていないか、インターフェイスを使用できません。 |
NDIS_STATUS_INVALID_PARAMETER |
NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS 構造体の1つ以上のメンバーに無効な値があります。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーの長さは、sizeoff(NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS)未満です。 PF ミニポートドライバーは、 NDIS_OID_REQUEST 構造体の DATA.SET_INFORMATION.BytesNeeded メンバーを設定する必要があります。 |
NDIS_STATUS_FAILURE |
その他の理由で要求に失敗しました。 |
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |