GET_VIRTUAL_DEVICE_DATA 콜백 함수(wdm.h)

GetVirtualFunctionData 루틴은 단일 루트 I/O 가상화(SR-IOV) 인터페이스를 지원하는 디바이스의 VF(가상 함수)의 PCI Express(PCIe) 구성 공간에서 데이터를 읽습니다.

구문

GET_VIRTUAL_DEVICE_DATA GetVirtualDeviceData;

ULONG GetVirtualDeviceData(
  [in, out] PVOID Context,
  [in]      USHORT VirtualFunction,
  [out]     PVOID Buffer,
  [in]      ULONG Offset,
  [in]      ULONG Length
)
{...}

매개 변수

[in, out] Context

인터페이스별 컨텍스트 정보에 대한 포인터입니다. 호출자는 인터페이스에 대한 PCI_VIRTUALIZATION_INTERFACE 구조체의 컨텍스트 멤버로 전달되는 값을 전달합니다.

[in] VirtualFunction

데이터를 읽을 디바이스의 VF를 지정하는 0부터 시작하는 값입니다.

[out] Buffer

VF의 PCIe 구성 공간에서 읽은 구성 정보를 포함하는 버퍼에 대한 포인터입니다.

[in] Offset

VF의 PCIe 구성 공간 데이터에 대한 오프셋입니다. 이 멤버는 이 읽기 작업이 시작되는 위치를 지정합니다.

[in] Length

읽을 데이터의 길이(바이트)입니다.

반환 값

GetVirtualFunctionData 루틴은 성공적인 읽기 작업 후에 읽은 PCIe 구성 데이터의 길이를 바이트 단위로 반환합니다. 읽기 작업이 실패하면 루틴은 0을 반환합니다.

설명

GetVirtualFunctionData 루틴은 디바이스의 PF(물리적 함수)가 아닌 VF에서 PCIe 구성 데이터를 읽는다는 점을 제외하고 GetBusData 루틴과 유사합니다.

GetVirtualFunctionData 루틴은 GUID_PCI_VIRTUALIZATION_INTERFACE 인터페이스에서 제공됩니다. GetBusData 루틴은 GUID_BUS_INTERFACE_STANDARD 인터페이스에서 제공됩니다.

가상화 스택은 게스트 운영 체제에서 실행되는 드라이버가 GetBusData 루틴을 호출할 때 GetVirtualFunctionData를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Server 2012 이상 버전의 Windows에서 지원됩니다.
대상 플랫폼	데스크톱
머리글	wdm.h(Wdm.h 포함)
IRQL	IRQL <= APC_LEVEL

추가 정보

PCI_VIRTUALIZATION_INTERFACE

GetBusData