VPCI_READ_BLOCK回呼函式 ()

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

語法

VPCI_READ_BLOCK VpciReadBlock;

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

Context

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

BlockId

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

Buffer

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

Length

[in]要從 VF 組態區塊讀取的位元元組數目。

注意

此參數的值不能超過 VPCI_MAX_READ_WRITE_BLOCK_SIZE。

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

呼叫 ReadVfConfigBlock 例程時，會通知 PF 的驅動程式從指定的 VF 組態區塊傳回數據。

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

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

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

注意

IOCTL_VPCI_READ_BLOCK IOCTL 提供 ReadVfConfigBlock 例程的異步替代方案。