OID_SWITCH_NIC_ARRAY

  • 아티클

Hyper-V 확장 가능 스위치 확장은 배열을 가져오기 위해 OID_SWITCH_NIC_ARRAY OID(개체 식별자) 쿼리 요청을 실행합니다. 배열의 각 요소는 확장 가능한 스위치 포트와 연결된 가상 네트워크 어댑터의 구성 매개 변수를 지정합니다.

OID 쿼리 요청이 성공적으로 완료되면 NDIS_OID_REQUEST 구조의 InformationBuffer 멤버에 버퍼에 대한 포인터가 포함됩니다. 이 버퍼에는 다음 데이터가 포함됩니다.

  • 배열의 요소 수를 정의하는 NDIS_SWITCH_NIC_ARRAY 구조체입니다. 이 구조체는 배열의 첫 번째 요소에 대한 오프셋도 지정합니다.

  • NDIS_SWITCH_NIC_PARAMETERS 구조체의 배열입니다. 이러한 각 구조에는 확장 가능한 스위치 포트에 연결된 네트워크 어댑터에 대한 정보가 포함됩니다.

    참고 확장 가능한 스위치 포트에 연결된 네트워크 어댑터가 없는 경우 확장 가능한 스위치의 기본 미니포트 가장자리는 NDIS_SWITCH_NIC_ARRAY 구조체의 NumElements 멤버를 0으로 설정합니다. 이 경우 NDIS_SWITCH_NIC_PARAMETERS 구조체가 반환되지 않습니다.

설명

OID_SWITCH_NIC_ARRAY OID는 Hyper-V 확장 가능 스위치가 활성화를 완료한 경우에만 발급되어야 합니다. 자세한 내용은 Hyper-V 확장 가능한 스위치 구성 쿼리 를 참조하세요.

확장이 반환된 NDIS_SWITCH_NIC_PARAMETERS 구조체를 처리하는 경우 NicFriendlyName과 같은 NDIS_SWITCH_PORT_PARAMETERS 구조체의 다양한 문자열 멤버가 NULL로 종료되었다고 가정해서는 안 됩니다. 이러한 문자열 멤버에 대한 데이터 형식은 IF_COUNTED_STRING 구조체에 의해 형식으로 정의됩니다. 드라이버는 이 구조체의 Length 멤버 값에서 문자열 길이를 결정해야 합니다.

참고 문자열이 null로 종료된 경우 Length 멤버는 종료되는 null 문자를 포함하지 않아야 합니다.

반환 상태 코드

확장 가능한 스위치의 기본 미니포트 에지는 OID_SWITCH_NIC_ARRAY OID 쿼리 요청을 완료하고 다음 상태 코드 중 하나를 반환합니다.

상태 코드 Description

NDIS_STATUS_SUCCESS

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

NDIS_STATUS_INVALID_LENGTH

정보 버퍼의 길이가 너무 작아 서 NDIS_SWITCH_NIC_ARRAY 및 NDIS_SWITCH_NIC_PARAMETERS 요소의 배열을 반환할 수 없습니다 . 확장 가능한 스위치의 기본 미니포트 가장자리는 DATA를 설정합니다 . QUERY_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다.

NDIS_STATUS_FAILURE

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

요구 사항

Version

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

헤더

 Ntddndis.h(Ndis.h 포함)

추가 정보

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_ARRAY

NDIS_SWITCH_NIC_PARAMETERS

Hyper-V 확장 가능한 스위치 구성 쿼리