Hyper-V 확장 가능한 스위치의 프로토콜 가장자리는 확장 가능한 스위치 정책 속성에 대한 매개 변수 업데이트에 대해 확장 가능한 스위치 확장에 알리기 위해 OID_SWITCH_PROPERTY_UPDATE OID(개체 식별자) 집합 요청을 실행합니다.
NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버는 버퍼에 대한 포인터를 포함합니다. 이 버퍼에는 다음 데이터가 포함됩니다.
확장 가능한 스위치 정책의 식별 및 형식을 지정하는 NDIS_SWITCH_PROPERTY_PARAMETERS 구조체입니다.
확장 가능한 스위치 정책에 대한 매개 변수를 포함하는 속성 버퍼입니다. 속성 버퍼에는 NDIS_SWITCH_PROPERTY_PARAMETERS 구조체의 PropertyType 멤버를 기반으로 하는 구조체가 포함되어 있습니다.
참고 Windows Server 2012부터 PropertyType 멤버를 NdisSwitchPropertyTypeCustom 설정해야 하며 속성 버퍼에는 NDIS_SWITCH_PROPERTY_CUSTOM 구조가 포함되어야 합니다.
발언
전달 확장은 OID_SWITCH_PROPERTY_UPDATE OID 집합 요청을 처리할 수 있습니다. 다른 모든 유형의 확장은 확장 가능한 스위치 드라이버 스택의 다음 확장으로 OID 요청을 전달하려면 NdisFOidRequest 호출해야 합니다.
확장은 OID 요청에 대한 NDIS_STATUS_DATA_NOT_ACCEPTED 반환하여 switch 속성의 업데이트를 거부할 수 있습니다. 예를 들어 확장에서 스위치에 업데이트된 정책을 적용하기 위해 리소스를 할당할 수 없는 경우 업데이트 요청을 거부해야 합니다.
참고 확장이 다른 NDIS_STATUS_Xxx 오류 상태 코드를 반환하는 경우 생성 알림도 거부됩니다. 그러나 NDIS_STATUS_RESOURCES 반환과 같은 일시적인 시나리오에 대한 상태 코드를 반환하면 생성 알림이 다시 시도될 수 있습니다.
확장에서 OID 요청을 거부하지 않는 경우 요청이 완료될 때 상태를 모니터링해야 합니다. 확장은 확장 가능한 스위치 제어 경로 또는 확장 가능한 스위치 인터페이스의 기본 확장에 의해 OID 요청이 거부되었는지 여부를 확인하기 위해 이 작업을 수행해야 합니다.
OID_SWITCH_PROPERTY_UPDATE OID 집합 요청을 처리하는 방법에 대한 지침은 스위치 정책 관리참조하세요.
반환 상태 코드
확장이 OID_SWITCH_PROPERTY_UPDATE OID 집합 요청을 완료하면 다음 상태 코드 중 하나가 반환됩니다.
| 상태 코드 | 묘사 |
|---|---|
NDIS_STATUS_DATA_NOT_ACCEPTED |
확장에서 스위치 정책 업데이트 알림을 거부했습니다. |
NDIS_STATUS_FAILURE |
다른 이유로 인해 OID 요청이 실패했습니다. |
확장이 OID_SWITCH_PROPERTY_UPDATE OID 집합 요청을 완료하지 않으면 확장 가능한 스위치의 기본 미니포트 에지에 의해 요청이 완료됩니다. 미니포트 에지는 다음 상태 코드를 반환합니다.
| 상태 코드 | 묘사 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 요청이 성공적으로 완료되었습니다. |
요구 사항
버전 |
NDIS 6.30 이상에서 지원됩니다. |
머리글 |
Ntddndis.h(Ndis.h 포함) |