OID_SWITCH_NIC_DISCONNECT

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

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

설명

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

확장은 OID_SWITCH_NIC_DISCONNECT OID 집합 요청을 처리할 때 다음 지침을 따라야 합니다.

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

  • OID_SWITCH_NIC_DISCONNECT 요청은 확장 가능한 스위치 연결이 지정된 네트워크 어댑터와 확장 가능한 스위치 포트 간에 해제되고 있음을 확장에 알렸습니다. 확장이 이 OID 요청을 처리한 후에는 다음을 수행하면 안 됩니다.

    • OID_SWITCH_NIC_DISCONNECT OID 요청이 실행된 확장 가능한 스위치 포트에서 네트워크 어댑터 연결에 대한 패킷 트래픽을 생성합니다.

    • ReferenceSwitchNic를 호출하여 확장 가능한 스위치 포트에서 지정된 네트워크 어댑터 연결에 대한 확장 가능한 스위치 참조 카운터를 증분합니다.

    • OID_SWITCH_NIC_DISCONNECT OID 요청이 실행된 기본 네트워크 어댑터에 OID_SWITCH_NIC_REQUEST OID 요청을 전달하거나 시작합니다.

      참고 OID_SWITCH_NIC_DISCONNECT 실행되기 전에 확장 가능한 스위치 참조 카운터를 증가하기 위해 ReferenceSwitchNic 라는 확장이 실행되면 확장은 여전히 OID 요청을 전달하거나 시작합니다.

    • OID_SWITCH_NIC_DISCONNECT OID 요청이 실행된 기본 네트워크 어댑터에서 NDIS 상태 NDIS_STATUS_SWITCH_NIC_STATUS 표시를 전달하거나 시작합니다.

      참고 OID_SWITCH_NIC_DISCONNECT 실행되기 전에 확장 가능한 스위치 참조 카운터를 증가하기 위해 ReferenceSwitchNic라는 확장이 실행되면 확장은 여전히 NDIS 상태 표시를 전달하거나 시작합니다.

      참고 확장이 이전에 ReferenceSwitchNic라고 하여 확장 가능한 스위치 참조 카운터를 증가시키는 경우 OID 요청을 시작하거나 전달하기 위해 호출을 동기화하거나 Hyper-V 확장 가능한 스위치 OID 요청을 관리하는 코드와 NDIS 상태 표시를 동기화할 필요가 없습니다. 확장이 참조 카운터를 증가하면 확장 가능한 스위치 인터페이스는 OID_SWITCH_NIC_DELETE OID 집합 요청을 실행하지 않습니다.

  • 확장은 항상 이 OID 집합 요청을 기본 확장으로 전달해야 합니다. 확장이 요청을 완료하면 안됩니다.

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

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

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

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

반환 상태 코드

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

상태 코드 Description

NDIS_STATUS_SUCCESS

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

요구 사항

Version

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

헤더

Ntddndis.h(Ndis.h 포함)

추가 정보


NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort