OID_SWITCH_PORT_PROPERTY_ADD

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

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

포트 정책에 대한 매개 변수의 식별 및 형식을 지정하는 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 구조체입니다.
포트 정책에 대한 매개 변수를 포함하는 속성 버퍼입니다. 속성 버퍼에는 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 구조체의 PropertyType 멤버를 기반으로 하는 구조체가 포함되어 있습니다. 예를 들어 PropertyType 멤버가 NdisSwitchPortPropertyTypeVlan으로 설정된 경우 속성 버퍼에는 NDIS_SWITCH_PORT_PROPERTY_VLAN 구조가 포함됩니다.

설명

전달 확장은 OID_SWITCH_PORT_PROPERTY_ADD OID 집합 요청을 처리할 수 있습니다. 확장 가능한 스위치 드라이버 스택에서 OID 요청을 다음 확장으로 전달하려면 다른 모든 유형의 확장이 NdisFOidRequest 를 호출해야 합니다.

확장은 OID 요청에 대한 NDIS_STATUS_DATA_NOT_ACCEPTED 반환하여 포트 속성 추가를 거부할 수 있습니다. 예를 들어 확장에서 포트에 구성된 정책을 적용하기 위해 리소스를 할당할 수 없는 경우 추가 요청을 거부해야 합니다.

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

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

OID_SWITCH_PORT_PROPERTY_ADD OID 집합 요청을 처리하는 방법에 대한 지침은 포트 정책 관리를 참조하세요.

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

상태 코드	Description
NDIS_STATUS_INVALID_LENGTH	정보 버퍼의 길이가 너무 작아 서 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 구조체와 구조체의 속성 버퍼에 있는 데이터를 처리할 수 없습니다. 확장은 DATA를 설정합니다 . SET_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다.
NDIS_STATUS_DATA_NOT_ACCEPTED	전달 확장에서 포트 정책 추가 알림을 거부했습니다.
NDIS_STATUS_NOT_SUPPORTED	전달 확장은 포트 정책을 지원하지 않습니다.
NDIS_STATUS_Xxx	다른 이유로 OID 요청이 실패했습니다.