NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS 構造体 (ntddndis.h)

  • [アーティクル]

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS構造体は、ネットワーク アダプターの PCI Express (PCIe) 仮想関数 (VF) の構成ブロックに対する書き込み操作のパラメーターを指定します。 これらのパラメーターは、VF と PCIe 物理機能 (PF) ミニポート ドライバー間のバックチャネル通信に使用されます。

構文

typedef struct _NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS;

メンバー

Header

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS構造体の型、リビジョン、およびサイズ。 このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ドライバーは、Header の Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS構造体のバージョンを指定するには、ドライバーは Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

NDIS 6.30 以降の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1] に設定します。

VFId

ネットワーク アダプター上の VF の一意識別子を指定するNDIS_SRIOV_FUNCTION_ID値。

メモ 指定したNDIS_SRIOV_FUNCTION_ID値を持つ VF には、OID_NIC_SWITCH_ALLOCATE_VFのオブジェクト識別子 (OID) メソッド要求によって以前に割り当てられたリソース が必要です。
 

BlockId

書き込む VF 構成ブロックの識別子を指定する ULONG 値。 この識別子は、独立したハードウェア ベンダー (IHV) に固有であり、ネットワーク アダプター上の PF と VF のミニポート ドライバーによってのみ使用されます。

詳細については、「解説」を参照してください。

Length

書き込み操作の長さをバイト単位で指定する ULONG 値。

BufferOffset

この構造体の先頭から、指定した VF 構成ブロックに書き込まれるデータを含むバッファーまでのオフセットをバイト単位で指定する ULONG 値。

注釈

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS構造体は、OID_SRIOV_WRITE_VF_CONFIG_BLOCKの OID セット要求で使用されます。

VF 構成ブロックは、PCIe PF のドライバーと SR-IOV インターフェイスをサポートするデバイス上の VF の間のバックチャネル通信に使用されます。 VF 構成ブロックからのデータは、次のドライバー間で交換できます。

  • ゲスト オペレーティング システムで実行される VF ミニポート ドライバー。 このオペレーティング システムは、Hyper-V 子パーティション内で実行されます。
  • 管理オペレーティング システムで実行される PF ミニポート ドライバー。

    このオペレーティング システムは、Hyper-V 親パーティション内で実行されます。

メモ VF 構成ブロックの使用法とその構成データの形式は、デバイスの独立したハードウェア ベンダー (IHV) によって定義されます。 構成データは、PF ミニポート ドライバーと VF ミニポート ドライバーによってのみ使用されます。
 
シングル ルート I/O 仮想化 (SR-IOV) インターフェイス内のバックチャネル通信の詳細については、「 SR-IOV PF/VF バックチャネル通信」を参照してください。

要件

要件 値
サポートされている最小のクライアント NDIS 6.30 以降でサポートされています。
Header ntddndis.h (Ndis.h を含む)

こちらもご覧ください

NDIS_OBJECT_HEADER

OID_SRIOV_WRITE_VF_CONFIG_BLOCK