OID_SRIOV_VF_INVALIDATE_CONFIG_BLOCK
NDIS は、複数の構成ブロック内のデータが変更されたことを PCI Express (PCIe) 仮想関数 (VF) のミニポート ドライバーに通知するOID_SRIOV_VF_INVALIDATE_CONFIG_BLOCKのオブジェクト識別子 (OID) メソッド要求を発行します。 NDIS は、PCIe 物理関数 (PF) のミニポート ドライバーが NdisMInvalidateConfigBlockを呼び出ときに、この OID を発行します。
この NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには NDIS_SRIOV_VF_INVALIDATE_CONFIG_BLOCK_INFO 構造体へのポインターが含まれています。 この構造体は、PF ミニポート ドライバーによってデータが変更された(無効化された)1 つ以上の仮想関数 (VF) 構成ブロックを指定します。
解説
VF 構成ブロックは、PF ミニポート ドライバーと VF ミニポート ドライバー間のバックチャネルコミュニケーションに使用されます。 IHV は、デバイスの 1 つ以上の VF 構成ブロックを定義できます。 各 VF 構成ブロックには、IHV で定義された形式、長さ、およびブロック ID があります。
注 各 VF 構成ブロックからのデータは、PF および VF ミニポート ドライバーによってのみ使用されます。
VF 構成データは、次のドライバー間で交換されます:
ゲスト オペレーティング システムで実行されるVF ドライバー。 このオペレーティング システムは、Hyper-V 子パーティション内で実行されます。
管理オペレーティング システムで実行される PF ドライバー。 このオペレーティング システムは、Hyper-V 親パーティション内で実行されます。
無効な VF 構成データの通知を処理するために、NDIS およびミニポート ドライバーは、次の手順を実行します:
ゲスト オペレーティング システムでは、NDISが IOCTL_VPCI_INVALIDATE_BLOCK のI/O 制御要求を発行します。 この IOCTL が完了すると、VF 構成データが変更されたことが NDIS に通知されます。
管理オペレーティング・システムでは、以下のステップが実行されます:
PF ミニポート ドライバーは、 NdisMInvalidateConfigBlock 関数を呼び出して、VF 構成データが変更され、有効ではなくなったことを NDIS に通知します。 ドライバーは、どの VF 構成ブロックが変更されたかを指定する ULONGLONG ビットマスクに BlockMask パラメーターを設定します。 ビットマスク内の各ビットは、VF 構成ブロックに対応します。 ビットが 1 に設定されている場合、対応する VF 構成ブロック内のデータが変更されました。
NDIS は、VF 構成ブロック データへの変更について、管理オペレーティング システムで実行される仮想化スタックを通知します。 仮想化スタックは、 BlockMask パラメーターデータをキャッシュします。
注 PF ミニポート ドライバーが NdisMInvalidateConfigBlockを呼び出すたびに、 仮想化スタックは BlockMask パラメーター データとキャッシュ内の現在値とを OR 演算します。
仮想化スタックは、VF 構成データの無効化について、ゲスト オペレーティング システムで実行される仮想 PCI (VPCI) ドライバーに通知します。 仮想化スタックは、キャッシュされた BlockMask パラメーター データを VPCI ドライバーに送信します。
ゲスト オペレーティング・システムでは、以下のステップが実行されます:
VPCI ドライバーは、キャッシュされた BlockMask パラメーターデータを、 IOCTL_VPCI_INVALIDATE_BLOCK 要求に関連付けられている VPCI_INVALIDATE_BLOCK_OUTPUT 構造体の BlockMask メンバーに保存します。
VPCI ドライバーは、 IOCTL_VPCI_INVALIDATE_BLOCK 要求を正常に完了します。 この場合、NDIS は、VF ミニポート ドライバーにOID_SRIOV_VF_INVALIDATE_CONFIG_BLOCKの OID メソッド要求を発行します。 NDIS_SRIOV_VF_INVALIDATE_CONFIG_BLOCK_INFO はOID 要求で渡されます。 この構造体には、キャッシュされた BlockMask パラメーターデータを含んでいます。
NDIS は、VF 構成データへの変更の連続した通知を処理する別の IOCTL_VPCI_INVALIDATE_BLOCK 要求も発行します。
VF ドライバーは、OID_SRIOV_VF_INVALIDATE_CONFIG_BLOCK 要求を処理するときに、指定された VF 構成ブロックからデータを読み取ります。
シングル ルート I/O 仮想化 (SR-IOV) インターフェイス内のバックチャネル コミュニケーションの詳細については、 SR-IOV PF/VF バックチャネル コミュニケーション を参照してください。
状態コードを返します
PF ミニポート ドライバーは、OID_SRIOV_OID_VF_CONFIG_BLOCK のメソッド要求の次の状態コードのいずれかを返します:
状態コード | 説明 |
---|---|
NDIS_STATUS_SUCCESS |
OID 要求は正常に完了しました。 |
NDIS_STATUS_NOT_SUPPORTED |
ミニポート ドライバーがシングル ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートしていないか、インターフェイスの使用が有効になっていません。 |
NDIS_STATUS_INVALID_PARAMETER |
DIS_SRIOV_VF_INVALIDATE_CONFIG_BLOCK_INFO 構造体の1つ以上のメンバーに無効な値があります。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーが短すぎました。 NDIS は、 NDIS_OID_REQUEST 構造体の DATA.SET_INFORMATION.BytesNeeded メンバーを NDIS_SRIOV_VF_INVALIDATE_CONFIG_BLOCK_INFO 構造体のサイズに設定します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求に失敗しました。 |
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |
関連項目
NDIS_SRIOV_VF_INVALIDATE_CONFIG_BLOCK_INFO