VPCI_WRITE_BLOCK回呼函式 ( ()

WriteVfConfigBlock 例程會寫入 PCI Express 虛擬函式的組態數據區塊， (VF) 。此例程是由支援單一根 I/O 虛擬化 (SR-IOV) 介面之裝置上的 PCIe VF 驅動程式呼叫。

語法

VPCI_WRITE_BLOCK VpciWriteBlock;

NTSTATUS VpciWriteBlock(
  PVOID Context,
  ULONG BlockId,
  PVOID Buffer,
  ULONG Length
)
{...}

Context

[in]介面特定內容資訊的指標。呼叫端會傳遞值，這個值會當做介面之VPCI_INTERFACE_STANDARD結構的Context成員傳遞。

BlockId

[in]要寫入之 VF 組態區塊的標識碼。此標識元專屬於獨立硬體廠商 (IHV) ，而且只有裝置上 PCIe 實體函式的驅動程式 (PF) 和 VF 使用。

Buffer

[in]呼叫端配置的緩衝區指標，其中包含要寫入的組態數據。如需詳細資訊，請參閱＜備註＞。

Length

[in]要寫入 VF 組態區塊的位元元組數目。

注意

此參數的值不能超過 VPCI_MAX_READ_WRITE_BLOCK_SIZE。

如果作業成功， ReadVfConfigBlock 例程會傳回 STATUS_SUCCESS 。否則，例程會傳回適當的NTSTATUS值。

呼叫 WriteVfConfigBlock 例程時，會通知 PF 的驅動程式以使用指定的數據更新指定的 VF 組態區塊。

VF 組態區塊用於PCIe PF驅動程式與支援SR-IOV介面之裝置上的 VF 之間的反向通道通訊。 IHV 可以定義裝置的一或多個 VF 組態區塊。每個 VF 組態區塊都有 IHV 定義的格式、長度和區塊識別碼。

VF 組態數據可以透過受保護的方式在下列驅動程式之間交換：

每個 VF 組態區塊的數據只會由 PF 和 VF 的驅動程式使用。

注意

IOCTL_VPCI_WRITE_BLOCK IOCTL 提供 WriteVfConfigBlock 例程的異步替代方案。