次の方法で共有

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 構造体として書式設定されます。

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

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

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

Size メンバーを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) インターフェイス内のバックチャネル通信の詳細については、PF/VF バックチャネル通信 SR-IOV を参照してください。

必要条件

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

関連項目

NDIS_OBJECT_HEADER

OID_SRIOV_READ_VF_CONFIG_BLOCK