다음을 통해 공유


OID_SRIOV_RESET_VF

오버리싱 드라이버는 단일 루트 I/O 가상화를 지원하는 네트워크 어댑터에서 지정된 PCI Express(PCIe) VF(가상 함수)를 다시 설정하기 위해 OID_SRIOV_RESET_VF OID(개체 식별자) 집합 요청을 실행합니다. 오버리싱 드라이버는 네트워크 어댑터의 PCI Express(PCIe) PF(물리적 함수)의 미니포트 드라이버에 이 OID 집합 요청을 실행합니다.

NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버는 NDIS_SRIOV_RESET_VF_PARAMETERS 구조체에 대한 포인터를 포함합니다. 오버리싱 드라이버는 이 구조체의 VFId 멤버를 통해 재설정할 VF의 식별자를 지정합니다.

설명

VF는 PCI Express(PCIe) FLR(함수 수준 재설정)을 통해 다시 설정할 수 있습니다. FLR 요청은 권한 있는 작업이므로 Hyper-V 부모 파티션의 관리 운영 체제에서 실행되는 PF 미니포트 드라이버에서만 수행할 수 있습니다. 관리 운영 체제에서 실행되는 오버리싱 드라이버는 FLR 요청에 대한 알림을 받고 PF 미니포트 드라이버에 OID_SRIOV_RESET_VF OID 집합 요청을 실행합니다.

이 OID 요청을 처리하는 경우 PF 미니포트 드라이버는 다음 지침을 따라야 합니다.

  • PF 미니포트 드라이버는 NDIS_SRIOV_RESET_VF_PARAMETERS 구조체의 VFId 멤버로 지정된 VF에 이전에 할당된 리소스가 있는지 확인해야 합니다. PF 미니포트 드라이버는 OID_NIC_SWITCH_ALLOCATE_VF OID 메서드 요청 중에 VF에 대한 리소스를 할당합니다. 지정된 VF에 대한 리소스가 할당되지 않은 경우 드라이버는 OID 요청에 실패해야 합니다.

  • 다시 설정 작업은 지정된 VF에만 영향을 주어야 합니다. 이 작업은 동일한 네트워크 어댑터의 다른 VF 또는 PF에 영향을 미치지 않아야 합니다.

자세한 내용은 가상 함수 다시 설정을 참조하세요.

반환 상태 코드

PF 미니포트 드라이버는 OID_SRIOV_RESET_VF 설정된 요청에 대해 다음 상태 코드 중 하나를 반환합니다.

상태 코드 Description

NDIS_STATUS_SUCCESS

OID 요청이 성공적으로 완료되었습니다.

NDIS_STATUS_NOT_SUPPORTED

PF 미니포트 드라이버는 단일 루트 I/O 가상화(SR-IOV) 인터페이스를 지원하지 않거나 인터페이스를 사용할 수 없습니다.

NDIS_STATUS_INVALID_PARAMETER

NDIS_SRIOV_RESET_VF_PARAMETERS 구조체의 멤버 중 하나 이상에 잘못된 값이 있습니다.

NDIS_STATUS_INVALID_LENGTH

정보 버퍼가 너무 짧습니다. PF 미니포트 드라이버는 데이터를 설정해야 합니다 . SET_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다.

NDIS_STATUS_FAILURE

다른 이유로 인해 요청이 실패했습니다.

요구 사항

Version

NDIS 6.30 이상에서 지원됩니다.

헤더

Ntddndis.h(Ndis.h 포함)

추가 정보


NDIS_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF