OID_SRIOV_WRITE_VF_CONFIG_BLOCK
上位ドライバーは、PCI Express (PCIe) 仮想関数 (VF) 構成ブロックにデータを書き込む OID_SRIOV_WRITE_VF_CONFIG_BLOCK のオブジェクト識別子 (OID) セット要求を発行します。
上位ドライバーは、ネットワークアダプターの PCIe 物理関数 (PF) 用ミニポートドライバーにこの OID セット要求を発行します。 この OID メソッド要求は、シングルルート I/O 仮想化 (SR-IOV) インターフェイスをサポートする PF ミニポート ドライバーに必要です。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、呼び出し元によって割り当てられたバッファーへのポインターが含まれています。 このバッファーは、次のようにフォーマットされます：
この構造体の先頭から VF 構成ブロックに書き込まれたデータを含むバッファー内の位置までのオフセットをバイト単位で含む NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS 構造体。
指定された VF 構成ブロックにデータを書き込むための追加バッファー領域。
解説
VF 構成ブロックは、PF ミニポート ドライバーと VF ミニポート ドライバー間のバックチャネルコミュニケーションに使用されます。 IHVは、ミニポート・ドライバー用に1つ以上の VF 構成ブロックを定義できます。 各 VF 構成ブロックには、IHV で定義された形式、長さ、およびブロック ID があります。
注 各 VF 構成ブロックからのデータは、PF および VF ミニポート ドライバーによってのみ使用されます。
OID_SRIOV_WRITE_VF_CONFIG_BLOCKの OID セット要求を発行する前に、上位ドライバーは、 NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS 構造体のメンバーを次のように設定する必要があります。
VFId メンバーを、情報を書き込むため VF の識別子に設定します。
BlockId メンバーを、情報を書き込む構成ブロックの識別子に設定します。
Length メンバーを VF 構成ブロックに書き込むためのバイト数に設定します。
メンバーを、指定された VF 構成ブロックから書き込まれたデータを含むバッファー内のオフセットへ BufferOffset メンバーを（ InformationBuffer メンバーによって参照される）に設定します。 このオフセットは、 NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS 構造体の先頭からバイト単位で指定されます。
OID_SRIOV_WRITE_VF_CONFIG_BLOCKの OID セット要求を処理する場合、PF ミニポート ドライバーは、これらのガイドラインに従う必要があります：
PF ミニポート ドライバーは、 NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS 構造体の VFId メンバーによって指定された VF に、以前に割り当てられているリソースがあることを確認する必要があります。 PF ミニポート ドライバーは、 OID_NIC_SWITCH_ALLOCATE_VF メソッド要求の間に VF のリソースを割り当てます。 指定した VF のリソースが割り当てられていない場合、ドライバーは OID 要求に失敗する必要があります。
PF ミニポートドライバーは、 NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS 構造体の BlockId メンバーが有効な VF 構成ブロックを指定していることを確認する必要があります。 そうでない場合、ドライバーは OID 要求を失敗する必要があります。
シングル ルート I/O 仮想化 (SR-IOV) インターフェイス内のバックチャネル コミュニケーションの詳細については、 SR-IOV PF/VF バックチャネル コミュニケーション を参照してください。
状態コードを返します
PF ミニポート ドライバーは、OID_SRIOV_WRITE_VF_CONFIG_BLOCK のセット要求の次の状態コードのいずれかを返します：
| 状態コード | 説明 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求は正常に完了しました。 |
NDIS_STATUS_NOT_SUPPORTED |
ミニポート ドライバーがシングル ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートしていないか、インターフェイスの使用が有効になっていません。 |
NDIS_STATUS_INVALID_PARAMETER |
NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS 構造体の1つ以上のメンバーに無効な値があります。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーが短すぎました。 NDIS は、 NDIS_OID_REQUEST 構造体の DATA.SET_INFORMATION.BytesNeeded メンバーに必要最小限のバッファサイズを設定します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求に失敗しました。 |
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |