NdisMSetVirtualFunctionBusData 함수(ndis.h)

아티클
02/29/2024

미니포트 드라이버는 NdisMSetVirtualFunctionBusData 함수를 호출하여 네트워크 어댑터의 VF(가상 함수)의 PCI Express(PCIe) 구성 공간에 데이터를 씁니다.

참고NdisMGetVirtualFunctionBusData 는 네트워크 어댑터의 PCIe PF(물리적 함수)에 대한 미니포트 드라이버에서만 호출해야 합니다.

구문

ULONG NdisMSetVirtualFunctionBusData(
  [in] NDIS_HANDLE            NdisMiniportHandle,
  [in] NDIS_SRIOV_FUNCTION_ID VFId,
  [in] PVOID                  Buffer,
  [in] ULONG                  Offset,
  [in] ULONG                  Length
);

매개 변수

[in] NdisMiniportHandle

NDIS가 MiniportInitializeEx의 MiniportAdapterHandle 매개 변수에 전달한 네트워크 어댑터 핸들입니다.

[in] VFId

데이터가 PCI 구성 공간에 기록되는 VF의 식별자입니다.

[in] Buffer

PCI 구성 공간에 쓸 데이터가 포함된 버퍼에 대한 포인터입니다.

[in] Offset

데이터가 기록되는 PCI 구성 공간의 오프셋(바이트 단위)입니다.

[in] Length

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

반환 값

NdisMSetVirtualFunctionBusData 는 PCI 구성 공간에 기록된 바이트 수를 반환합니다. 쓰기 작업이 실패하면 NdisMSetVirtualFunctionBusData 는 0을 반환합니다.

설명

PF 미니포트 드라이버는 일반적으로 OID_SRIOV_WRITE_VF_CONFIG_SPACE OID 메서드 요청을 처리할 때 NdisMSetVirtualFunctionBusData를 호출합니다.
그러나 드라이버는 NdisMEnableVirtualization 호출을 통해 네트워크 어댑터에서 가상화를 사용하도록 설정한 후 언제든지 이 함수를 호출할 수 있습니다.

단일 루트 I/O 가상화(SR-IOV) 인터페이스 내의 백채널 통신에 대한 자세한 내용은 SR-IOV PF/VF 백채널 통신을 참조하세요.

SR-IOV 인터페이스에 대한 자세한 내용은 SR-IOV(단일 루트 I/O 가상화) 개요를 참조하세요.

Virtual Bus 드라이버에 연결

IHV(독립 하드웨어 공급업체)가 SR-IOV 드라이버 패키지의 일부로 VBD(가상 버스 드라이버)를 제공하는 경우 미니포트 드라이버는 NdisMSetVirtualFunctionBusData를 호출하지 않아야 합니다. 대신 드라이버는 프라이빗 통신 채널을 통해 VBD와 인터페이스하고 VBD가 SetVirtualFunctionData를 호출하도록 요청해야 합니다. 이 함수는 기본 PCI 버스 드라이버에서 지원하는 GUID_PCI_VIRTUALIZATION_INTERFACE 인터페이스에서 노출됩니다.

Hyper-V 부모 파티션의 관리 운영 체제에서 실행되는 VBD는 PCI 버스의 물리적 디바이스 개체(PDO)에 IRP_MN_QUERY_INTERFACE 요청을 실행하여 GUID_PCI_VIRTUALIZATION_INTERFACE 인터페이스를 쿼리할 수 있습니다. 이 요청은 IRQL = PASSIVE_LEVEL 만들어야 합니다. 이 요청에서 드라이버는 InterfaceType 매개 변수를 GUID_PCI_VIRTUALIZATION_INTERFACE 설정해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.30 이상에서는 지원되지 않습니다.
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	유니버설
헤더	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	<= DISPATCH_LEVEL