OID_SWITCH_PROPERTY_ENUM
Hyper-V 확장 가능 스위치 확장은 배열을 가져오기 위해 OID_SWITCH_PROPERTY_ENUM OID(개체 식별자) 메서드 요청을 실행합니다. 이 배열에는 지정된 조건과 일치하는 프로비전된 스위치 정책이 포함되어 있습니다. 배열의 각 요소는 확장 가능한 스위치 정책의 속성을 지정합니다.
NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 버퍼에 대한 포인터가 포함되어 있습니다. 이 버퍼에는 다음 데이터가 포함됩니다.
확장 가능한 스위치 정책 열거형에 대한 매개 변수를 지정하는 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 구조체입니다.
NDIS_SWITCH_PROPERTY_ENUM_INFO 구조체의 배열입니다. 이러한 각 구조에는 확장 가능한 스위치 정책에 대한 정보가 포함됩니다.
참고 확장이 지정된 확장 가능한 스위치 정책의 인스턴스로 프로비전되지 않은 경우 확장은 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 구조체의 NumProperties 멤버를 0으로 설정하고 NDIS_SWITCH_PROPERTY_ENUM_INFO 구조체가 반환되지 않습니다.
설명
OID_SWITCH_PROPERTY_ENUM OID는 Hyper-V 확장 가능 스위치가 활성화를 완료한 경우에만 발급되어야 합니다. 자세한 내용은 Hyper-V 확장 가능한 스위치 구성 쿼리 를 참조하세요.
OID_SWITCH_PORT_PROPERTY_ENUM OID 쿼리 요청과 달리 확장은 확장 가능한 스위치 드라이버 스택에서 OID_SWITCH_PROPERTY_ENUM 요청을 발급할 때 ReferenceSwitchXxx 또는 DereferenceSwitchXxx 함수를 호출할 필요가 없습니다.
참고 확장이 OID_SWITCH_PROPERTY_ENUM OID 메서드 요청을 수신하는 경우 OID 요청을 완료하면 안 됩니다. 대신 NdisFOidRequest 를 호출하여 확장 가능한 스위치 드라이버 스택 아래로 OID 요청을 전달해야 합니다.
반환 상태 코드
확장 가능한 스위치의 기본 미니포트 에지는 OID_SWITCH_PROPERTY_ENUM OID 쿼리 요청을 완료하고 다음 상태 코드 중 하나를 반환합니다.
| 상태 코드 | Description |
|---|---|
NDIS_STATUS_SUCCESS |
OID 요청이 성공적으로 완료되었습니다. |
NDIS_STATUS_INVALID_LENGTH |
정보 버퍼의 길이가 너무 작아 서 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 구조와 NDIS_SWITCH_PROPERTY_ENUM_INFO 요소의 배열을 반환할 수 없습니다 . 확장 가능한 스위치의 기본 미니포트 가장자리는 DATA를 설정합니다 . METHOD_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다. |
NDIS_STATUS_FAILURE |
다른 이유로 인해 요청이 실패했습니다. |
요구 사항
Version |
NDIS 6.30 이상에서 지원됩니다. |
헤더 |
Ntddndis.h(Ndis.h 포함) |
추가 정보
NDIS_SWITCH_PROPERTY_ENUM_INFO