NDIS_SRIOV_CAPABILITIES 구조체(ntddndis.h)

아티클
08/07/2023

NDIS_SRIOV_CAPABILITIES 구조는 네트워크 어댑터의 단일 루트 I/O 가상화(SR-IOV) 기능을 지정합니다.

구문

typedef struct _NDIS_SRIOV_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              SriovCapabilities;
} NDIS_SRIOV_CAPABILITIES, *PNDIS_SRIOV_CAPABILITIES;

멤버

Header

NDIS_SRIOV_CAPABILITIES 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.

미니포트 드라이버는 헤더의 Type 멤버를 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다. NDIS_SRIOV_CAPABILITIES 구조체의 버전을 지정하려면 드라이버가 Header의 Revision 멤버를 다음 값으로 설정해야 합니다.

NDIS_SRIOV_CAPABILITIES _REVISION_1

NDIS 6.30 이상에 대한 원래 버전입니다.

Size 멤버를 NDIS_SIZEOF_SRIOV_CAPABILITIES _REVISION_1 설정합니다.

Flags

플래그의 비트 OR을 포함하는 ULONG 값입니다. 이 멤버는 NDIS용으로 예약되어 있습니다.

SriovCapabilities

다음 플래그의 비트 OR을 포함하는 ULONG 값입니다.

NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

네트워크 어댑터가 SR-IOV 기능을 지원한다고 지정합니다.

참고 이 플래그는 네트워크 어댑터의 PCI Express(PCIe) PF(물리적 함수)에 대한 미니포트 드라이버에서만 설정해야 합니다. 이 드라이버는 관리 운영 체제에서 실행됩니다. 이 운영 체제는 Hyper-V 부모 파티션에서 실행됩니다.

NDIS_SRIOV_CAPS_PF_MINIPORT

PF 미니포트 드라이버임을 지정합니다.

NDIS_SRIOV_CAPS_VF_MINIPORT

PCIe VF(가상 함수) 미니포트 드라이버임을 지정합니다.

설명

미니포트 드라이버는 NDIS_SRIOV_CAPABILITIES 구조를 사용하여 SR-IOV 기능을 다음과 같은 방법으로 보고합니다.

미니포트 드라이버는 MiniportInitializeEx 함수에서 NdisMSetMiniportAttributes 함수를 호출하고 MiniportAttributes 매개 변수를 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조체에 대한 포인터로 설정합니다. 드라이버는 HardwareSriovCapabilities 및 CurrentSriovCapabilities 멤버를 NDIS_SRIOV_CAPABILITIES 구조체로 포맷하여 SR-IOV 지원을 보급합니다.
드라이버가 OID_SRIOV_HARDWARE_CAPABILITIES 또는 OID_SRIOV_CURRENT_CAPABILITIES OID 쿼리 요청을 성공적으로 처리하면 NDIS_SRIOV_CAPABILITIES 구조가 반환됩니다.

NDIS는 네트워크 어댑터의 SR-IOV 기능을 다음과 같은 방법으로 네트워크 어댑터에 바인딩하는 드라이버에 전달합니다.

NDIS가 지나치게 많은 필터 드라이버의 FilterAttach 함수를 호출하면 NDIS는 AttachParameters 매개 변수를 통해 네트워크 어댑터의 SR-IOV 기능을 전달합니다. 이 매개 변수는 NDIS_FILTER_ATTACH_PARAMETERS 구조체에 대한 포인터를 포함합니다. 이 구조체의 SriovCapabilities 멤버는 NDIS_SRIOV_CAPABILITIES 구조체에 대한 포인터를 포함합니다.
NDIS가 지나치게 많은 프로토콜 드라이버의 ProtocolBindAdapterEx 함수를 호출하면 NDIS는 BindParameters 매개 변수를 통해 네트워크 어댑터의 SR-IOV 기능을 전달합니다. 이 매개 변수는 NDIS_FILTER_ATTACH_PARAMETERS 구조체에 대한 포인터를 포함합니다. 이 구조체의 SriovCapabilities 멤버는 NDIS_SRIOV_CAPABILITIES 구조체에 대한 포인터를 포함합니다.