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