OID_NIC_SWITCH_VPORT_PARAMETERS

아티클
06/15/2023

오버리싱 드라이버는 SR-IOV(단일 루트 I/O 가상화)를 지원하는 네트워크 어댑터에 생성된 NIC 스위치에서 VPort(가상 포트)에 대한 매개 변수를 가져올 수 있습니다. 드라이버는 이러한 매개 변수를 가져오기 위해 OID_NIC_SWITCH_VPORT_PARAMETERS OID(개체 식별자) 메서드 요청을 발급합니다.

오버리싱 드라이버는 네트워크 어댑터의 NIC 스위치에 연결된 지정된 VPort의 구성 매개 변수를 설정하기 위해 OID_NIC_SWITCH_VPORT_PARAMETERS OID 집합 요청을 실행합니다. 이러한 OID 집합 요청은 네트워크 어댑터의 PCI Express(PCIe) PF(물리적 함수)의 미니포트 드라이버에 발급됩니다. 이러한 OID 집합 요청은 단일 루트 I/O 가상화(SR-IOV) 인터페이스를 지원하는 PF 미니포트 드라이버에 필요합니다.

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

오버리싱 드라이버는 OID 메서드에 대한 VPort를 지정하거나 NDIS_NIC_SWITCH_VPORT_PARAMETERS 구조체의 VPortId 멤버를 VPort와 연결된 식별자로 설정하여 요청을 설정합니다. 오버리싱 드라이버는 다음 방법 중 하나를 통해 VPort 식별자를 가져옵니다.

이전 OID 메서드 요청에서 OID_NIC_SWITCH_CREATE_VPORT.
이전 OID 메서드 요청에서 OID_NIC_SWITCH_ENUM_VPORTS.

설명

OID_NIC_SWITCH_VPORT_PARAMETERS OID 메서드 요청 또는 OID 집합 요청에서 사용할 수 있습니다.

OID_NIC_SWITCH_VPORT_PARAMETERS OID 메서드 요청 처리

오버리싱 드라이버는 네트워크 어댑터의 NIC 스위치에 연결된 VPort의 현재 구성 매개 변수를 쿼리하기 위해 OID_NIC_SWITCH_VPORT_PARAMETERS OID 메서드 요청을 실행합니다. 오버리싱 드라이버는 NDIS_NIC_SWITCH_VPORT_PARAMETERS 구조체의 VPortId 멤버를 VPort 식별자로 설정하여 쿼리할 VPort를 지정합니다.

NDIS는 미니포트 드라이버에 대한 OID_NIC_SWITCH_VPORT_PARAMETERS OID 메서드 요청을 처리합니다. NDIS는 OID_NIC_SWITCH_CREATE_VPORT 및 OID_NIC_SWITCH_ENUM_VPORTS 이전 OID 요청에서 얻은 정보를 반환합니다.

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

자세한 내용은 가상 포트의 매개 변수 쿼리를 참조하세요.

OID_NIC_SWITCH_VPORT_PARAMETERS OID 집합 요청 처리

오버리싱 드라이버는 네트워크 어댑터의 NIC 스위치에 연결된 VPort의 현재 구성 매개 변수를 변경하기 위해 OID_NIC_SWITCH_VPORT_PARAMETERS OID 집합 요청을 실행합니다. 이 OID 요청은 기본값 및 기본값이 아닌 VPort에 대한 매개 변수를 업데이트하는 데 사용할 수 있습니다.

VPort에 대한 구성 매개 변수의 제한된 하위 집합만 변경할 수 있습니다. 오버리싱 드라이버는 NDIS_NIC_SWITCH_VPORT_PARAMETERS 구조체의 다음 멤버를 설정하여 변경할 매개 변수를 지정합니다.

VPortId 멤버는 매개 변수가 변경될 VPort의 식별자로 설정됩니다.
적절한 NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED 플래그는 Flags 멤버에 설정됩니다. NDIS_NIC_SWITCH_VPORT_PARAMETERS 구조체의 멤버는 해당 NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED 플래그가 Ntddndis.h에 정의된 경우에만 변경할 수 있습니다.
NDIS_NIC_SWITCH_VPORT_PARAMETERS 구조체의 해당 멤버는 변경할 VPort 구성 매개 변수로 설정됩니다.

PF 미니포트 드라이버가 OID_NIC_SWITCH_VPORT_PARAMETERS OID 집합 요청을 받은 후 드라이버는 구성 매개 변수를 사용하여 하드웨어를 구성합니다. 드라이버는 NDIS_NIC_SWITCH_VPORT_PARAMETERS 구조체의 Flags 멤버에서 NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED 플래그로 식별된 구성 매개 변수만 변경할 수 있습니다.

자세한 내용은 가상 포트의 매개 변수 설정을 참조하세요.

반환 상태 코드

NDIS 또는 PF 미니포트 드라이버는 OID_NIC_SWITCH_VPORT_PARAMETERS 설정 또는 메서드 OID 요청에 대해 다음 상태 코드를 반환합니다.

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