OID_NIC_SWITCH_VF_PARAMETERS

아티클
06/15/2023

오버리싱 드라이버 또는 사용자 모드 애플리케이션은 네트워크 어댑터에서 PCI Express(PCIe) VF(가상 함수)의 현재 구성 매개 변수를 가져오기 위해 OID_NIC_SWITCH_VF_PARAMETERS 개체 식별자(OID) 메서드 요청을 실행합니다. OID_NIC_SWITCH_ALLOCATE_VF OID 메서드 요청을 통해 할당된 리소스가 있는 VF만 OID_NIC_SWITCH_VF_PARAMETERS OID 메서드 요청을 통해 쿼리할 수 있습니다.

NDIS는 미니포트 드라이버에 대한 OID_NIC_SWITCH_VF_PARAMETERS OID 메서드 요청을 처리합니다.

OID 메서드 요청이 이루어지면 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에 NDIS_NIC_SWITCH_VF_PARAMETERS 구조체에 대한 포인터가 포함됩니다.

설명

오버리싱 드라이버 또는 사용자 모드 애플리케이션은 NDIS_NIC_SWITCH_VF_PARAMETERS 구조체의 VFId 멤버를 VF의 식별자로 설정하여 쿼리할 VF를 지정합니다. 오버리싱 드라이버 또는 애플리케이션은 다음 방법 중 하나를 통해 VF 식별자를 가져옵니다.

OID_NIC_SWITCH_ENUM_VFS OID 메서드 요청을 실행합니다.

이 OID 요청이 성공적으로 완료되면 오버리싱 드라이버 또는 사용자 모드 애플리케이션은 네트워크 어댑터에 할당된 모든 VF 목록을 받습니다. 목록 내의 각 요소는 VFId 멤버가 지정한 VF 식별자를 사용하여 NDIS_NIC_SWITCH_VF_INFO 구조체입니다.
OID_NIC_SWITCH_ALLOCATE_VF OID 메서드 요청을 실행합니다.

이 OID 요청이 성공적으로 완료되면 오버리싱 드라이버는 반환된 NDIS_NIC_SWITCH_VF_PARAMETERS 구조체의 VFId 멤버에서 새로 만든 VF의 식별자를 받습니다.

참고 오버리싱 드라이버만 이러한 방식으로 VF 식별자를 가져올 수 있습니다.

OID 메서드 요청에서 성공적으로 반환된 후 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 NDIS_NIC_SWITCH_VF_PARAMETERS 구조체에 대한 포인터가 포함됩니다. 이 구조체에는 지정된 VF에 대한 구성 매개 변수가 포함됩니다.

반환 상태 코드

NDIS는 미니포트 드라이버에 대한 OID_NIC_SWITCH_VF_PARAMETERS OID 메서드 요청을 처리하고 OID_NIC_SWITCH_VF_PARAMETERS OID 메서드 요청에 대해 다음 상태 코드를 반환합니다.

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