VPCI_INTERFACE_STANDARD 구조체(vpci.h)

아티클
03/09/2023

VPCI_INTERFACE_STANDARD 인터페이스 구조를 사용하면 디바이스 드라이버가 단일 루트 I/O 가상화(SR-IOV) 인터페이스를 지원하는 디바이스의 PCI Express(PCIe) VF(가상 함수)와 관련된 구성 데이터 블록에 액세스할 수 있습니다.

이 구조체는 GUID_VPCI_INTERFACE_STANDARD 인터페이스를 설명합니다.

참고

VF 구성 블록의 위치 및 구성 데이터의 형식은 디바이스의 IHV(독립 하드웨어 공급업체)에 의해 정의됩니다. PCIe PF(물리적 함수) 및 VF의 드라이버에서만 사용됩니다.

구문

typedef struct _VPCI_INTERFACE_STANDARD {
  USHORT                 Size;
  USHORT                 Version;
  PVOID                  Context;
  PINTERFACE_REFERENCE   InterfaceReference;
  PINTERFACE_DEREFERENCE InterfaceDereference;
  PVPCI_WRITE_BLOCK      WriteVfConfigBlock;
  PVPCI_READ_BLOCK       ReadVfConfigBlock;
  UINT32                 SerialNumber;
} VPCI_INTERFACE_STANDARD, *PVPCI_INTERFACE_STANDARD;

멤버

Size

이 구조체의 크기(바이트)입니다.

Version

드라이버 정의 인터페이스 버전입니다.

Context

인터페이스별 컨텍스트 정보에 대한 포인터입니다.

InterfaceReference

인터페이스의 참조 수를 증가시키는 InterfaceReference 루틴에 대한 포인터입니다.

InterfaceDereference

인터페이스의 참조 수를 감소시키는 InterfaceDereference 루틴에 대한 포인터입니다.

WriteVfConfigBlock

PCIe VF에 대한 구성 데이터 블록을 작성하는 WriteVfConfigBlock 루틴에 대한 포인터입니다.

ReadVfConfigBlock

PCIe VF에 대한 구성 데이터 블록을 읽는 ReadVfConfigBlock 루틴에 대한 포인터입니다.

SerialNumber

디바이스의 PCIe VF에 대한 일련 번호를 포함하는 UINT32 값입니다. 가상화 스택은 디바이스에 노출되는 각 VF에 대해 고유한 일련 번호를 생성합니다.

설명

GUID_VPCI_INTERFACE_STANDARD 인터페이스는 VPCI(가상 PCI) 버스 드라이버가 VF에 대해 로드된 드라이버 아래에 계층화된 PDO(물리적 디바이스 개체)를 만듭니다. 이러한 드라이버는 Hyper-V 자식 파티션에서 실행되는 게스트 운영 체제에 로드됩니다.

드라이버는 InterfaceType이 GUID_VPCI_INTERFACE_STANDARD 설정된 버스 드라이버에 IRP_MN_QUERY_INTERFACE IRP를 전송하여 VPCI_INTERFACE_STANDARD 구조체에 대한 포인터를 가져옵니다.