共用方式為

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS 結構 (ntddndis.h)

  • 發行項

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS 結構會指定網路適配器 PCI Express (PCIe) Virtual Function (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 結構。

迷你埠驅動程序必須將 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 和更新版本的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1。

VFId

NDIS_SRIOV_FUNCTION_ID值，指定網路適配器上 VF 的唯一標識碼。

注意 具有指定NDIS_SRIOV_FUNCTION_ID值的 VF 必須具有先前透過 OID_NIC_SWITCH_ALLOCATE_VF OID 方法要求配置的資源。
 

BlockId

ULONG 值，指定要讀取之 VF 組態區塊的標識碼。 此標識元專屬於獨立硬體廠商 (IHV) ，而且只能由網路適配器上 PF 和 VF 的迷你埠驅動程式使用。

如需詳細資訊，請參閱＜備註＞一節。

Length

ULONG 值，指定讀取作業的長度，以位元組為單位。

BufferOffset

ULONG 值，指定從這個 結構的開頭到包含從指定 VF 組態區塊讀取之數據的緩衝區，以位元組為單位指定位移。

備註

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 Backchannel Communication。

規格需求

需求 值
最低支援的用戶端 NDIS 6.30 和更新版本支援。
標頭 ntddndis.h (包含 Ndis.h)

另請參閱

NDIS_OBJECT_HEADER

OID_SRIOV_READ_VF_CONFIG_BLOCK