OID_NIC_SWITCH_ENUM_SWITCHES

지나치게 많은 드라이버 또는 사용자 모드 애플리케이션은 배열을 가져오기 위해 OID_NIC_SWITCH_ENUM_SWITCHES OID(개체 식별자) 쿼리 요청을 실행합니다. 배열의 각 요소는 네트워크 어댑터에서 만든 NIC 스위치의 특성을 지정합니다.

이 OID 쿼리 요청에서 성공적으로 반환된 후 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 다음이 포함된 버퍼에 대한 포인터가 포함됩니다.

배열 내의 요소 수를 정의하는 NDIS_NIC_SWITCH_INFO_ARRAY 구조체입니다.
NDIS_NIC_SWITCH_INFO 구조체의 배열입니다. 이러한 각 구조에는 네트워크 어댑터에서 만든 단일 NIC 스위치에 대한 정보가 포함됩니다.

참고 네트워크 어댑터에 NIC 스위치가 없는 경우 드라이버는 NDIS_NIC_SWITCH_INFO_ARRAY 구조체의 NumElements 멤버를 0으로 설정하고 NDIS_NIC_SWITCH_INFO 구조가 반환되지 않습니다.

발언

드라이버와 사용자 모드 애플리케이션을 과도하게 지정하면 네트워크 어댑터에서 만든 NIC 스위치를 열거하기 위해 OID_NIC_SWITCH_ENUM_SWITCHES OID 쿼리 요청이 발생합니다.

참고 Windows Server 2012부터 단일 루트 I/O 가상화(SR-IOV) 인터페이스는 네트워크 어댑터의 기본 NIC 스위치만 지원합니다. 따라서 반환된 NDIS_NIC_SWITCH_INFO_ARRAY 구조체는 NDIS_DEFAULT_SWITCH_ID 식별자가 참조하는 기본 NIC 스위치에 대해 단일 NDIS_NIC_SWITCH_INFO 요소를 지정해야 합니다.

반환 상태 코드

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

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

상태 코드	묘사
NDIS_STATUS_SUCCESS	OID 요청이 성공적으로 완료되었습니다.
NDIS_STATUS_NOT_SUPPORTED	미니포트 드라이버는 SR-IOV 인터페이스를 지원하지 않거나 인터페이스를 사용할 수 없습니다.
NDIS_STATUS_INVALID_PARAMETER	NDIS_NIC_SWITCH_INFO_ARRAY 구조체의 하나 이상의 멤버에 잘못된 값이 있습니다.
NDIS_STATUS_INVALID_LENGTH	정보 버퍼가 너무 짧습니다. NDIS는 DATA를 설정합니다. QUERY_INFORMATION. NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버를 필요한 최소 버퍼 크기로 설정합니다.
NDIS_STATUS_FAILURE	다른 이유로 인해 요청이 실패했습니다.