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

Статья
02/07/2025

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

Синтаксис

GET_VIRTUAL_DEVICE_RESOURCES GetVirtualDeviceResources;

void GetVirtualDeviceResources(
  [in, out] PVOID Context,
  [out]     PUINT8 CapturedBusNumbers
)
{...}

Параметры

[in, out] Context

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

[out] CapturedBusNumbers

Указатель на указанную вызывающим переменную, в которой эта подпрограмма возвращает значение UINT8. Это значение указывает количество автобусов PCIe, которые были записаны для использования SR-IOV PF устройства.

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

Никакой

Замечания

Устройство PCIe обычно потребляет ресурсы на одной шине PCI. Драйвер PCI назначает устройство шине PCI, записывая номер шины в регистр дополнительного номера шины и номер подчиненной шины в порте верхнего моста. Этот порт является мостом PCI-to-PCI в корневом порту PCIe или портом коммутатора PCIe.

Устройство, поддерживающее интерфейс SR-IOV, может создавать больше виртуальных функций, чем можно разместить на шине PCI, на которой подключено устройство. В таких ситуациях порт верхнего моста должен быть настроен для записи одного или нескольких неиспользуемых автобусов PCI. Это делается путем записи большего значения в регистр подчиненной шины порта.

Устройство, поддерживающее интерфейс SR-IOV, должно записывать автобусы PCI, если по крайней мере одно из следующих значений имеет значение true:

Устройство имеет более восьми общих функций (PFs и VFs), и устройство не поддерживает вариант альтернативной интерпретации маршрутизации (ARI) спецификации PCI Express 3.0.
Устройство поддерживает ARI и имеет более восьми общих функций, но порт верхнего моста не поддерживает ARI.
Устройство поддерживает ARI и имеет более 256 функций, а порт верхнего моста поддерживает ARI.

Независимо от поддержки ARI каждая записанная шина может поддерживать 256 функций.

Если устройству требуется больше идентификаторов идентификаторов запросов PCIe (RID), чтобы включить все виртуальные машины, драйвер шины PCI выполняет следующее:

Записывает номер шины устройства в регистр вторичной шины PCIe.
Записывает значение, превышающее номер шины устройства, в регистр номера подчиненной шины PCIe.

Разница между этими двумя регистрируемыми значениями представляет количество захваченных номеров шины.

Подпрограмма GetResources предоставляется интерфейсом GUID_PCI_VIRTUALIZATION_INTERFACE.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в Windows Server 2012 и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	wdm.h (include Wdm.h)
IRQL	PASSIVE_LEVEL

См. также

PCI_VIRTUALIZATION_INTERFACE

Поделиться через