OID_SRIOV_HARDWARE_CAPABILITIES

아티클
06/14/2023

오버리싱 드라이버는 네트워크 어댑터의 단일 루트 I/O 가상화(SR-IOV) 하드웨어 기능을 얻기 위해 OID_SRIOV_HARDWARE_CAPABILITIES OID(개체 식별자) 쿼리 요청을 실행합니다.

NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버는 NDIS_SRIOV_CAPABILITIES 구조체에 대한 포인터를 포함합니다.

설명

NDIS_SRIOV_CAPABILITIES 구조에는 어댑터가 SR-IOV를 지원하는지 여부 및 미니포트 드라이버가 어댑터의 PCI Express(PCIe) PF(물리적 함수) 또는 VF(가상 함수)를 관리하는지 여부와 같은 네트워크 어댑터의 하드웨어 기능에 대한 정보가 포함됩니다. 이러한 기능에는 현재 INF 파일 설정 또는 고급 속성 페이지를 통해 사용하지 않도록 설정된 하드웨어 기능이 포함될 수 있습니다.

참고 네트워크 어댑터의 모든 SR-IOV 기능은 기능 사용 여부에 관계없이 OID_SRIOV_HARDWARE_CAPABILITIES OID 쿼리 요청을 통해 반환됩니다.

NDIS 6.30부터 미니포트 드라이버는 MiniportInitializeEx 함수가 호출되면 SR-IOV 하드웨어 기능을 제공합니다. 드라이버는 SR-IOV 하드웨어 기능을 사용하여 NDIS_SRIOV_CAPABILITIES 구조를 초기화하고 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조체의 HardwareSriovCapabilities 멤버를 NDIS_SRIOV_CAPABILITIES 구조체에 대한 포인터로 설정합니다. 그런 다음 미니포트 드라이버는 NdisMSetMiniportAttributes 함수를 호출하고 MiniportAttributes 매개 변수를 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조체에 대한 포인터로 설정합니다.

반환 상태 코드

NDIS는 미니포트 드라이버에 대한 OID_SRIOV_HARDWARE_CAPABILITIES 요청의 OID 쿼리 요청을 처리합니다. 드라이버에 이 OID 요청이 발급되지 않습니다.

NDIS가 OID_SRIOV_HARDWARE_CAPABILITIES 요청을 처리하면 다음 상태 코드 중 하나를 반환합니다.

상태 코드	Description
NDIS_STATUS_SUCCESS	OID 요청이 성공적으로 완료되었습니다.
NDIS_STATUS_NOT_SUPPORTED	미니포트 드라이버는 단일 루트 I/O 가상화(SR-IOV) 인터페이스를 지원하지 않거나 인터페이스를 사용할 수 없습니다.
NDIS_STATUS_INVALID_LENGTH	정보 버퍼가 너무 짧습니다. 미니포트 드라이버는 DATA를 설정해야 합니다 . QUERY_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다.
NDIS_STATUS_FAILURE	다른 이유로 인해 요청이 실패했습니다.