다음을 통해 공유


OID_SWITCH_PORT_TEARDOWN

Hyper-V 확장 가능 스위치의 프로토콜 에지는 OID_SWITCH_PORT_TEARDOWN 개체 식별자(OID) 집합 요청을 실행하여 확장 가능한 스위치 포트가 삭제 프로세스를 시작하도록 기본 확장 가능한 스위치 확장에 알립니다. 이 프로세스는 프로토콜 드라이버가 OID_SWITCH_PORT_DELETE OID 집합 요청을 발급할 때 시작됩니다.

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

설명

NDIS_SWITCH_PORT_PARAMETERS 구조체의 PortId 멤버는 연결 알림이 만들어지는 확장 가능한 스위치 포트를 지정합니다. 확장 가능한 스위치 확장은 다음과 같은 방법으로 가져온 포트에 대한 캐시된 정보를 업데이트해야 합니다.

확장 가능한 스위치의 프로토콜 에지는 확장 가능한 스위치에서 포트가 삭제되는 중임을 확장에 알리기 위해 OID_SWITCH_PORT_TEARDOWN OID 집합 요청을 실행합니다. 이 OID 요청을 실행하기 전에 포트에 활성 네트워크 어댑터 연결이 있는 경우 확장 가능한 스위치의 프로토콜 에지가 이전에 다음 OID를 실행했습니다.

  • OID_SWITCH_NIC_DISCONNECT 네트워크 어댑터가 NDIS_SWITCH_PORT_PARAMETERS 구조에 지정된 포트에 더 이상 연결되어 있지 않다는 것을 기본 확장에 알렸습니다.

  • OID_SWITCH_NIC_DELETE 네트워크 어댑터와 확장 가능한 스위치 포트 간의 네트워크 연결이 삭제되었음을 기본 확장에 알렸습니다.

    지정된 확장 가능한 스위치 포트에 대해 보류 중인 모든 패킷이 취소되거나 완료된 후 프로토콜 에지가 이 OID 집합 요청을 실행합니다.

확장이 이 OID 집합 요청을 완료하고 확장 가능한 스위치 포트에 대한 참조 카운터가 0이면 확장 가능한 스위치의 프로토콜 에지가 OID_SWITCH_PORT_DELETE OID 집합 요청을 실행합니다. 이 OID 요청은 확장 가능한 스위치에서 포트를 삭제합니다.

참고 확장은 ReferenceSwitchPort를 호출하여 확장 가능한 스위치 포트에 대한 참조 카운터를 증가합니다. 확장은 DereferenceSwitchPort를 호출하여 참조 카운터를 감소합니다.

확장은 OID_SWITCH_PORT_TEARDOWN OID 집합 요청을 처리하기 위해 다음 지침을 따라야 합니다.

  • 확장은 항상 이 OID 집합 요청을 기본 확장으로 전달해야 합니다. 확장이 요청에 실패하지 않아야 합니다.

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

  • 확장에서 이 OID 요청을 전달한 후에는 패킷을 삭제된 포트로 전달할 수 없습니다. 또한 확장은 삭제된 포트에 대해 OID 요청을 실행하거나 ReferenceSwitchPort 함수를 호출할 수 없습니다.

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

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

반환 상태 코드

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

상태 코드 설명

NDIS_STATUS_SUCCESS

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

요구 사항

버전

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

헤더

Ntddndis.h(Ndis.h 포함)

참고 항목


DereferenceSwitchPort

FilterAttach

NDIS_OID_REQUEST

NDIS_SWITCH_PARAMETERS

NDIS_SWITCH_PORT_PARAMETERS

NdisFOidRequest

NET_PNP_EVENT

OID_SWITCH_NIC_DELETE

OID_SWITCH_PARAMETERS

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort