OID_NIC_SWITCH_PARAMETERS

아티클
06/15/2023

오버리싱 드라이버는 네트워크 어댑터에서 지정된 NIC 스위치의 현재 구성 매개 변수를 가져오기 위해 OID_NIC_SWITCH_PARAMETERS OID(개체 식별자) 메서드 요청을 실행합니다. NDIS는 미니포트 드라이버에 대한 이러한 OID 메서드 요청을 처리합니다.

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

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

오버리싱 드라이버는 OID 메서드에 대한 NIC 스위치를 지정하거나 NDIS_NIC_SWITCH_PARAMETERS 구조체의 SwitchId 멤버를 스위치 식별자로 설정하여 요청을 설정합니다. 오버리싱 드라이버는 다음 방법 중 하나를 통해 스위치 식별자를 가져옵니다.

이전 OID 메서드 요청에서 OID_NIC_SWITCH_ENUM_SWITCHES.
NDIS_BIND_PARAMETERS 구조체의 NicSwitchArray 멤버에서 NDIS는 ProtocolBindAdapterEx 함수의 BindParameters 매개 변수에서 이 구조체에 대한 포인터를 전달합니다.
NDIS_FILTER_ATTACH_PARAMETERS 구조체의 NicSwitchArray 멤버에서 NDIS는 FilterAttach 함수의 AttachParameters 매개 변수에서 이 구조체에 대한 포인터를 전달합니다.

참고 Windows Server 2012 Windows는 네트워크 어댑터에서 기본 NIC 스위치만 지원합니다. NDIS_NIC_SWITCH_PARAMETERS 구조체의 SwitchId 멤버는 NDIS_DEFAULT_SWITCH_ID 설정해야 합니다.

설명

오버리싱 드라이버는 다음과 같은 방식으로 OID_NIC_SWITCH_PARAMETERS 요청을 실행합니다.

오버리싱 드라이버는 지정된 NIC 스위치의 현재 매개 변수를 가져오기 위해 OID_NIC_SWITCH_PARAMETERS OID 메서드 요청을 실행합니다. 자세한 내용은 NIC 스위치의 매개 변수 쿼리를 참조하세요.

참고 NDIS는 PF 미니포트 드라이버에 대한 OID_NIC_SWITCH_PARAMETERS OID 메서드 요청을 처리합니다.
오버리싱 드라이버는 지정된 NIC 스위치의 현재 매개 변수를 변경하기 위해 OID_NIC_SWITCH_PARAMETERS OID 집합 요청을 실행합니다. 자세한 내용은 NIC 스위치의 매개 변수 설정을 참조하세요.

참고 PF 미니포트 드라이버는 OID_NIC_SWITCH_PARAMETERS OID 집합 요청을 처리합니다.

반환 상태 코드

NDIS 또는 PF 미니포트 드라이버는 OID_NIC_SWITCH_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_PARAMETERS 구조체의 멤버 중 하나 이상에 잘못된 값이 있습니다.
NDIS_STATUS_INVALID_LENGTH	정보 버퍼가 너무 짧습니다. NDIS 또는 PF 미니포트 드라이버는 데이터를 설정합니다. METHOD_INFORMATION. BytesNeeded 멤버(OID 메서드 요청의 경우) 또는 DATA. SET_INFORMATION. 필요한 최소 버퍼 크기로 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버(OID 집합 요청의 경우)입니다.
NDIS_STATUS_REINIT_REQUIRED	PF 미니포트 드라이버는 NIC 스위치에 변경 내용을 적용하기 위해 네트워크 어댑터를 다시 초기화해야 합니다.
NDIS_STATUS_FAILURE	다른 이유로 인해 요청이 실패했습니다.