다음을 통해 공유


OID_SWITCH_PORT_DELETE

Hyper-V 확장 가능 스위치의 프로토콜 에지는 확장 가능한 스위치 확장에 확장 가능한 스위치 포트 삭제에 대해 알리기 위해 OID_SWITCH_PORT_DELETE OID(개체 식별자) 집합 요청을 실행합니다.

NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 NDIS_SWITCH_PORT_PARAMETERS 구조체에 대한 포인터가 포함되어 있습니다.

설명

NDIS_SWITCH_PORT_PARAMETERS 구조체의 PortId 멤버는 삭제 알림이 만들어지는 확장 가능한 스위치 포트를 지정합니다.

네트워크 어댑터가 지정된 포트에 연결된 경우 확장 가능한 스위치의 프로토콜 가장자리는 포트를 삭제하기 전에 연결을 삭제합니다. 이 경우 프로토콜 에지는 포트를 삭제하기 전에 다음 단계를 수행합니다.

  • 프로토콜 에지는 네트워크 어댑터와 확장 가능한 스위치 포트 간의 연결이 삭제되고 있음을 확장에 알리기 위해 OID_SWITCH_NIC_DISCONNECT OID 집합 요청을 실행합니다.

  • 지정된 확장 가능한 스위치 포트에 대한 보류 중인 모든 패킷이 취소되거나 완료된 후 프로토콜 에지는 네트워크 어댑터와 확장 가능한 스위치 포트 간의 연결이 삭제되었음을 확장에 알리기 위해 OID_SWITCH_NIC_DELETE OID 집합 요청을 발급합니다.

    이 시점에서 프로토콜 에지가 포트를 삭제하기 시작할 수 있습니다.

확장 가능한 스위치의 프로토콜 에지는 확장 가능한 스위치 포트를 삭제할 때 다음 단계를 따릅니다.

  1. 확장 가능한 스위치의 프로토콜 에지가 OID_SWITCH_PORT_TEARDOWN OID 집합 요청을 실행합니다. 이 OID 요청은 확장 가능한 스위치 포트에 대한 삭제 프로세스의 시작에 대해 기본 확장 가능한 스위치 확장에 알렸습니다.

  2. 프로토콜 에지는 확장 가능한 스위치 포트에 대한 모든 OID 요청이 완료된 후 OID_SWITCH_PORT_DELETE OID 집합 요청을 실행합니다.

    참고 확장이 이전에 ReferenceSwitchPort를 호출하여 포트의 참조 카운터를 증가한 경우 프로토콜 에지가 OID_SWITCH_NIC_DELETE 요청을 발급하기 전에 DereferenceSwitchPort를 호출해야 합니다.

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

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

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

  • NDIS_STATUS_SUCCESS OID_SWITCH_PORT_DELETE 요청이 완료되면 확장은 삭제된 포트에 대한 패킷 또는 OID 요청을 받지 않습니다. 확장은 삭제된 포트에 패킷을 전달할 수 없습니다. 또한 확장은 삭제된 포트에 대해 OID 요청을 실행하거나 ReferenceSwitchPort 함수를 호출할 수 없습니다.

참고 확장 가능한 스위치 확장은 OID_SWITCH_PORT_DELETE OID 집합 요청을 실행해서는 안 됩니다.

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

반환 상태 코드

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

상태 코드 Description

NDIS_STATUS_SUCCESS

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

요구 사항

Version

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

헤더

Ntddndis.h(Ndis.h 포함)

추가 정보


DereferenceSwitchPort

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort