OID_SWITCH_PARAMETERS
Hyper-V 확장 가능 스위치 확장은 확장 가능한 스위치의 구성 데이터를 가져오기 위해 OID_SWITCH_PARAMETERS OID(개체 식별자) 쿼리 요청을 실행합니다.
OID 쿼리 요청이 성공적으로 완료되면 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에 NDIS_SWITCH_PARAMETERS 구조체에 대한 포인터가 포함됩니다.
설명
확장이 반환된 NDIS_SWITCH_PARAMETERS 구조체를 처리할 때 SwitchName과 같은 NDIS_SWITCH_PARAMETERS 구조체의 다양한 문자열 멤버가 null로 종료된다고 가정해서는 안됩니다. 이러한 문자열 멤버에 대한 데이터 형식은 IF_COUNTED_STRING 구조체에 의해 형식으로 정의됩니다. 확장은 이 구조체의 Length 멤버 값에서 문자열 길이를 결정해야 합니다.
참고 문자열이 null로 끝나는 경우 Length 멤버는 종료되는 null 문자를 포함하지 않아야 합니다.
반환 상태 코드
확장 가능한 스위치의 기본 미니포트 에지는 OID_SWITCH_PARAMETERS OID 쿼리 요청을 완료하고 다음 상태 코드 중 하나를 반환합니다.
| 상태 코드 | Description |
|---|---|
NDIS_STATUS_SUCCESS |
OID 요청이 성공적으로 완료되었습니다. |
NDIS_STATUS_INVALID_LENGTH |
정보 버퍼의 길이가 너무 작아서 OID 쿼리 요청에 대한 OID_SWITCH_PARAMETERS 구조를 반환할 수 없습니다. 확장 가능한 스위치의 기본 미니포트 가장자리는 DATA를 설정합니다 . QUERY_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다. |
NDIS_STATUS_FAILURE |
다른 이유로 인해 요청이 실패했습니다. |
요구 사항
Version |
NDIS 6.30 이상에서 지원됩니다. |
헤더 |
Ntddndis.h(Ndis.h 포함) |