функция обратного вызова VPCI_WRITE_BLOCK (vpci.h)

Программа WriteVfConfigBlock записывает блок данных конфигурации для виртуальной функции PCI Express (VF). Эта подпрограмма вызывается драйвером VF PCIe на устройстве, поддерживающем единый корневой интерфейс виртуализации ввода-вывода (SR-IOV).

Синтаксис

VPCI_WRITE_BLOCK VpciWriteBlock;

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

Параметры

Context

[in] Указатель на сведения о контексте для интерфейса. Вызывающий объект передает значение, передаваемое как элемент контекста контекста члена структуры VPCI_INTERFACE_STANDARD для интерфейса.

BlockId

[in] Идентификатор записываемого блока конфигурации VF. Этот идентификатор является владельцем независимого поставщика оборудования (IHV) и используется только драйверами физической функции PCIe (PF) и VF на устройстве.

Buffer

[in] Указатель на выделенный вызывающим буфером, который содержит данные конфигурации для записи. Дополнительные сведения см. в разделе "Примечания".

Length

[in] Число байтов, записываемых в блок конфигурации VF.

Заметка

Значение этого параметра не должно превышать VPCI_MAX_READ_WRITE_BLOCK_SIZE.

Возвращаемое значение

Подпрограмма readVfConfig Block возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае подпрограмма возвращает соответствующее значение NTSTATUS.

Замечания

Когда вызывается подпрограмма WriteVfConfigBlock, драйвер PF уведомляется об обновлении указанного блока конфигурации VF с указанными данными.

Блок конфигурации VF используется для взаимодействия между драйверами PCIe PF и VF на устройстве, поддерживающем интерфейс SR-IOV. IHV может определить один или несколько блоков конфигурации VF для устройства. Каждый блок конфигурации VF имеет определенный IHV формат, длину и идентификатор блока.

Данные конфигурации VF можно обмениваться следующими драйверами в защищенном режиме:

• Драйвер VF, который выполняется в гостевой операционной системе. Эта операционная система выполняется в дочерней секции Hyper-V.
• Драйвер PF, который выполняется в операционной системе управления. Эта операционная система выполняется в родительском разделе Hyper-V.

Данные из каждого блока конфигурации VF используются только драйверами PF и VF.

Заметка

IOCTL IOCTL_VPCI_WRITE_BLOCK предлагает асинхронную альтернативу подпрограмме WriteVfConfigBlock.

Требования

Требование	Ценность
минимальный поддерживаемый сервер	Windows Server 2012
заголовка	vpci.h
IRQL	<= DISPATCH_LEVEL

См. также

IOCTL_VPCI_WRITE_BLOCK

VPCI_INTERFACE_STANDARD