NdisMQueryProbedBars 함수(ndis.h)

아티클
08/07/2023

미니포트 드라이버는 NdisMQueryProbedBars 함수를 호출하여 네트워크 어댑터의 PCI Express(PCIe) BAR(기본 주소 레지스터)의 값을 가져옵니다. 이 함수는 PCI 버스 드라이버에서 수행한 쿼리에 따라 네트워크 어댑터에서 보고한 BAR 값을 반환합니다. 이 쿼리는 네트워크 어댑터에 필요한 메모리 또는 I/O 주소 공간을 결정합니다.

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

구문

NDIS_STATUS NdisMQueryProbedBars(
  [in]  NDIS_HANDLE NdisMiniportHandle,
  [out] PULONG      BaseRegisterValues
);

매개 변수

[in] NdisMiniportHandle

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

[out] BaseRegisterValues

ULONG 값 배열에 대한 포인터입니다. 배열에는 PCIe 네트워크 어댑터의 각 BAR에 대한 ULONG 값이 포함됩니다.

참고NdisMQueryProbedBars는 이 배열 내에서 최대 PCI_TYPE0_ADDRESSES 값을 반환합니다.

반환 값

NdisMQueryProbedBars는 다음 상태 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
NDIS_STATUS_SUCCESS	쿼리 작업이 성공적으로 완료되었습니다.
NDIS_STATUS_FAILURE	쿼리 작업이 실패했습니다.

설명

Hyper-V 부모 파티션의 관리 운영 체제에서 실행되는 PCI 버스 드라이버는 네트워크 어댑터의 각 PCI BAR(기본 주소 등록)의 메모리 또는 I/O 주소 공간 요구 사항을 쿼리합니다. PCI 버스 드라이버는 버스에서 어댑터를 처음 검색할 때 이 쿼리를 수행합니다.

이 PCI BAR 쿼리를 통해 PCI 버스 드라이버는 다음을 결정합니다.

네트워크 어댑터에서 PCI BAR를 지원하는지 여부입니다.
BAR가 지원되는 경우 BAR에 필요한 메모리 또는 I/O 주소 공간의 양입니다.

VPCI(가상 PCI) 버스 드라이버는 Hyper-V 자식 파티션의 게스트 운영 체제에서 실행됩니다. PCI Express(PCIe) VF(가상 함수)가 자식 파티션에 연결되면 VPCI 버스 드라이버는 VF(VF 네트워크 어댑터)에 대한 가상 네트워크 어댑터를 노출합니다. 이 작업을 수행하기 전에 VPCI 버스 드라이버는 PCI BAR 쿼리를 수행하여 VF 네트워크 어댑터에 필요한 필요한 메모리 또는 주소 공간을 확인해야 합니다.

PCI 구성 공간에 대한 액세스는 권한 있는 작업이므로 Hyper-V 부모 파티션의 관리 운영 체제에서 실행되는 구성 요소에서만 수행할 수 있습니다. VPCI 버스 드라이버가 PCI BAR을 쿼리할 때 NDIS는 PF 미니포트 드라이버에 OID_SRIOV_PROBED_BARS OID(개체 식별자) 쿼리 요청을 실행합니다. 이 OID 쿼리 요청에서 반환된 결과는 VPCI 버스 드라이버로 전달되므로 VF 네트워크 어댑터에 필요한 메모리 주소 공간을 확인할 수 있습니다.

이 OID 요청을 처리하는 동안 드라이버는 NdisMQueryProbedBars 를 호출하여 PCI 드라이버에서 수행하는 BAR 쿼리에서 반환된 값을 가져올 수 있습니다.

VF에 대한 PCI BAR 레지스터를 쿼리하는 방법에 대한 자세한 내용은 가상 함수의 PCI 기본 주소 레지스터 쿼리를 참조하세요.

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

Virtual Bus 드라이버에 연결

IHV(독립 하드웨어 공급업체)가 SR-IOV 드라이버 패키지의 일부로 VBD(가상 버스 드라이버)를 제공하는 경우 미니포트 드라이버는 NdisMQueryProbedBars를 호출해서는 안 됩니다. 대신 드라이버는 프라이빗 통신 채널을 통해 VBD와 인터페이스하고 VBD가 GetVirtualFunctionProbedBars를 호출하도록 요청해야 합니다. 이 함수는 기본 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 이상에서 지원됩니다.
대상 플랫폼	유니버설
헤더	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	PASSIVE_LEVEL

추가 정보

GUID_PCI_VIRTUALIZATION_INTERFACE

GetVirtualFunctionProbedBars

OID_SRIOV_PROBED_BARS

Share via