OID_SWITCH_PORT_CREATE

아티클
06/15/2023

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

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

설명

NDIS_SWITCH_PORT_PARAMETERS 구조체의 PortId 멤버는 생성 알림이 생성되는 포트를 지정합니다.

확장 가능한 스위치 확장은 OID_SWITCH_PORT_CREATE OID 집합 요청을 처리하기 위해 다음 지침을 따라야 합니다.

확장은 OID 요청과 연결된 NDIS_SWITCH_PORT_PARAMETERS 구조를 수정해서는 안됩니다.
확장은 OID 요청에 대한 NDIS_STATUS_DATA_NOT_ACCEPTED 반환하여 생성 알림을 거부할 수 있습니다. 예를 들어 확장에서 포트에 구성된 정책을 적용하기 위해 리소스를 할당할 수 없는 경우 드라이버는 생성 알림을 거부해야 합니다.

확장이 다른 NDIS_STATUS_Xxx 오류 상태 코드를 반환하는 경우 생성 알림도 거부됩니다. 그러나 NDIS_STATUS_RESOURCES 반환과 같은 일시적인 시나리오에 대한 상태 코드를 반환하면 생성 알림이 다시 시도됩니다.

확장이 OID 요청을 거부하지 않는 경우 요청이 완료되면 상태 모니터링해야 합니다. 확장은 확장 가능한 스위치 제어 경로의 기본 확장 또는 확장 가능한 스위치 인터페이스에 의해 OID 요청이 거부되었는지 여부를 확인하기 위해 이 작업을 수행해야 합니다.

포트 정책에 대한 자세한 내용은 Hyper-V 확장 가능한 스위치 정책 관리를 참조하세요.
확장이 NdisFOidRequest를 호출하여 이 OID 집합 요청을 전달하는 경우 확장은 이 OID 요청의 완료 상태 모니터링해야 합니다. 확장은 확장 가능한 스위치 드라이버 스택의 기본 확장이 포트 생성 알림을 거부했는지 여부를 감지하기 위해 이 작업을 수행합니다.
OID 요청이 전달되고 성공적으로 완료되면 확장은 OID_SWITCH_PORT_TEARDOWN OID 요청이 실행될 때까지 OID_SWITCH_PORT_PROPERTY_ENUM 같은 포트에 대한 OID 요청을 실행할 수 있습니다. 이 OID 요청은 확장 가능한 스위치에서 포트가 삭제 프로세스를 시작한다는 것을 확장에 알렸습니다.
확장은 OID_SWITCH_NIC_CONNECT OID 집합 요청이 실행되고 성공적으로 완료될 때까지 NDIS_SWITCH_PORT_PARAMETERS 구조의 지정된 포트로 패킷을 전달할 수 없습니다.

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

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

반환 상태 코드

확장이 OID_SWITCH_PORT_CREATE OID 집합 요청을 완료하면 다음 상태 코드 중 하나를 반환합니다.

상태 코드	Description
NDIS_STATUS_DATA_NOT_ACCEPTED	확장에서 생성 알림을 거부했습니다.
NDIS_STATUS_RESOURCES	확장은 리소스가 부족하여 생성 알림을 거부했습니다.
NDIS_STATUS_Xxx	확장은 다른 이유로 만들기 알림을 거부했습니다.