OID_SWITCH_PORT_CREATE

아티클
03/13/2025

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 집합 요청을 완료하면 다음 상태 코드 중 하나가 반환됩니다.

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