다음을 통해 공유


OID_SWITCH_NIC_CONNECT

Hyper-V 확장 가능 스위치의 프로토콜 에지는 확장 가능한 스위치 포트와 네트워크 어댑터 간의 네트워크 연결이 완전히 설정되었음을 기본 확장 가능한 스위치 확장에 알리기 위해 OID_SWITCH_NIC_CONNECT 개체 식별자(OID) 집합 요청을 실행합니다. 프로토콜 에지는 이전에 OID_SWITCH_NIC_CREATE OID 집합 요청을 실행했을 때 이 연결이 설정되고 있음을 확장에 알렸습니다.

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

설명

NDIS_SWITCH_NIC_PARAMETERS 구조체의 PortId 멤버는 연결 알림이 만들어지는 확장 가능한 스위치 포트를 지정합니다. 확장 가능한 스위치 확장은 다음과 같은 방법으로 이 포트 및 기타 확장 가능한 스위치 포트에 대한 매개 변수 정보를 가져올 수 있습니다.

NDIS_SWITCH_NIC_PARAMETERS 구조체의 인덱스 멤버는 연결 알림이 만들어지는 네트워크 어댑터의 인덱스를 지정합니다. 지정된 인덱스 값이 있는 네트워크 어댑터는 PortId 멤버가 지정한 확장 가능한 스위치 포트에 연결됩니다. 이러한 인덱스 값에 대한 자세한 내용은 네트워크 어댑터 인덱스 값을 참조 하세요.

OID_SWITCH_NIC_CONNECT OID 집합 요청을 받으면 확장은 다음 지침을 따라야 합니다.

  • NDIS_STATUS_SUCCESS OID_SWITCH_NIC_CONNECT 요청이 완료되면 네트워크 연결 및 확장 가능한 스위치 포트가 완전히 작동합니다. 확장은 패킷 트래픽을 생성하거나 포트의 네트워크 연결로 전달할 수 있습니다. 확장은 포트를 원본 포트로 사용하는 확장 가능한 스위치 OID 또는 상태 표시를 실행할 수도 있습니다. 또한 확장은 ReferenceSwitchPort를 호출하여 포트에 대한 확장 가능한 스위치 참조 카운터를 증분할 수 있습니다.

  • 확장은 OID 요청과 연결된 NDIS_SWITCH_NIC_PARAMETERS 구조를 수정해서는 안됩니다.

  • 확장은 항상 NdisFOidRequest를 호출하여 이 OID 요청을 기본 확장으로 전달해야 합니다. 확장은 OID 요청 자체를 완료하지 않아야 합니다.

  • 확장 가능한 스위치 외부 네트워크 어댑터는 하나 이상의 기본 물리적 어댑터에 바인딩할 수 있습니다. 외부 네트워크 어댑터에 바인딩된 모든 실제 네트워크 어댑터의 경우 확장 가능한 스위치의 프로토콜 에지가 OID_SWITCH_NIC_CONNECT 별도의 OID 집합 요청을 실행합니다. 각 OID 집합 요청은 다른 네트워크 어댑터 연결 인덱스 값을 지정합니다. 이러한 값에 대한 자세한 내용은 네트워크 어댑터 인덱스 값을 참조 하세요.

    확장은 외부 네트워크 어댑터에 바인딩된 각 기본 물리적 어댑터에 대한 연결 상태를 유지해야 합니다. 물리적 네트워크 어댑터를 외부 네트워크 어댑터에 바인딩할 수 있는 다양한 구성에 대한 자세한 내용은 물리적 네트워크 어댑터 구성 유형을 참조 하세요.

확장 은 OID_SWITCH_NIC_CONNECT 자체 OID 집합 요청을 실행해서는 안 됩니다.

확장 가능한 스위치 포트 및 네트워크 어댑터 연결 상태에 대한 자세한 내용은 Hyper-V 확장 가능한 스위치 포트 및 네트워크 어댑터 상태를 참조 하세요.

반환 상태 코드

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

상태 코드 설명

NDIS_STATUS_SUCCESS

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

요구 사항

버전

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

헤더

Ntddndis.h(Ndis.h 포함)

참고 항목


NdisFReturnNetBufferLists

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_CREATE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort