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_ARRAY OID 쿼리 요청을 실행합니다. 확장은 OID_SWITCH_PARAMETERS IsActive가 TRUE로 설정된 NDIS_SWITCH_PARAMETERS 구조를 반환하는 경우에만 FilterAttach에서 이 OID를 실행합니다. IsActive가 FALSE이면 확장 미니포트에서 NetEventSwitchActivate NET_PNP_EVENT 실행될 때 확장에서 OID를 발급합니다.
다양한 OID 집합의 OID_SWITCH_PORT_CREATE 및 OID_SWITCH_PORT_DELETE 요청을 검사합니다.
확장 가능한 스위치의 프로토콜 에지는 확장 가능한 스위치에서 포트가 삭제되는 중임을 확장에 알리기 위해 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 포함) |