共用方式為

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS 結構 (ntddndis.h)

  • 發行項

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS 結構會指定網路適配器 PCI Express (PCIe) Virtual Function (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 和更新版本的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1。

VFId

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

注意 具有指定NDIS_SRIOV_FUNCTION_ID值的 VF 必須具有先前透過物件識別碼配置的資源， (OID) 方法要求 OID_NIC_SWITCH_ALLOCATE_VF。
 

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