共用方式為

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 結構的版本，驅動程式必須將 Revision 成員設定為下列值 Header：

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

NDIS 6.30 和更新版本的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_SRIOV_WRITE_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_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 Backchannel Communication。

要求

要求 價值
最低支援的用戶端 NDIS 6.30 和更新版本支援。
標頭 ntddndis.h （包括 Ndis.h）

另請參閱

NDIS_OBJECT_HEADER

OID_SRIOV_WRITE_VF_CONFIG_BLOCK