NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS 構造体 (ntddndis.h)

  • [アーティクル]

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

構文

typedef struct _NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS;

メンバー

Header

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

ミニポート ドライバーは、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS構造体のバージョンを指定するには、ドライバーは Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

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

[サイズ] メンバーを [NDIS_SIZEOF_SRIOV_READ_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_READ_VF_CONFIG_BLOCK_PARAMETERS構造体は、OID_SRIOV_READ_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_READ_VF_CONFIG_BLOCK