VPCI_WRITE_BLOCK回呼函式 （VPCI_WRITE_BLOCK.h）
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 驅動程式。 此作系統會在 Hyper-V 子分割內執行。
- 在管理作系統中執行的 PF 驅動程式。 此作系統會在 Hyper-V 父分割區內執行。
每個 VF 組態區塊的數據只會由 PF 和 VF 的驅動程式使用。
注意
IOCTL_VPCI_WRITE_BLOCK IOCTL 提供 WriteVfConfigBlock 例程的異步替代方案。
要求
| 要求 | 價值 |
|---|---|
| 支援的最低伺服器 | Windows Server 2012 |
| 標頭 | httpi.h |
| IRQL | <= DISPATCH_LEVEL |