SET_VIRTUAL_DEVICE_DATA 콜백 함수(wdm.h)

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

구문

SET_VIRTUAL_DEVICE_DATA SetVirtualDeviceData;

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

매개 변수

[in, out] Context

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

[in] VirtualFunction

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

[in] Buffer

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

[in] Offset

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

[in] Length

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

반환 값

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

설명

*SetVirtualFunctionData 루틴은 디바이스의 PF(물리적 함수) 대신 VF에 PCIe 구성 데이터를 쓴다는 점을 제외하고 SetBusData 루틴과 유사합니다.

*SetVirtualFunctionData 루틴은 GUID_PCI_VIRTUALIZATION_INTERFACE 인터페이스에서 제공됩니다. SetBusData 루틴은 GUID_BUS_INTERFACE_STANDARD 인터페이스에서 제공됩니다.

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

요구 사항

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

추가 정보

SetBusData

PCI_VIRTUALIZATION_INTERFACE