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

Статья
02/07/2025

Извлекает сведения о текущем расположении устройства PCI на шине, например сегмент PCI, шина, номер устройства и функции.

Синтаксис

SRIOV_GET_DEVICE_LOCATION SriovGetDeviceLocation;

void SriovGetDeviceLocation(
  [in]  PVOID Context,
  [in]  USHORT VfIndex,
  [out] PUINT16 SegmentNumber,
  [out] PUINT8 BusNumber,
  [out] PUINT8 FunctionNumber
)
{...}

Параметры

[in] Context

Указатель на определяемый драйвером контекст.

[in] VfIndex

Отсчитываемый от нуля индекс VF, к которому применяется эта операция чтения.

[out] SegmentNumber

Указатель на переменную, заполненную текущим номером сегмента, который описывает группу шин PCI, к которой подключено это устройство.

[out] BusNumber

Указатель на переменную, заполненную текущим номером шины, в которой описывается шина PCI, к которой подключено это устройство.

[out] FunctionNumber

Указатель на переменную, заполненную параметром FunctionNumber, который далее описывает, где на этом автобусе можно найти устройство.

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

Никакой

Замечания

Эта функция обратного вызова реализуется драйвером физической функции (PF). Он вызывается, когда система хочет получить расположение устройства.

Драйвер PF регистрирует свою реализацию, задав GetDeviceLocation член SRIOV_DEVICE_INTERFACE_STANDARD, настройка структуры WDF_QUERY_INTERFACE_CONFIG и вызов WdfDeviceAddQueryInterface.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
заголовка	pcivirt.h
IRQL	PASSIVE_LEVEL

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