OID_GEN_ISOLATION_PARAMETERS

  • 아티클

NDIS 및 오버리싱 드라이버는 VM 네트워크 어댑터의 포트에 설정된 다중 테넌트 구성(격리) 매개 변수를 얻기 위해 OID_GEN_ISOLATION_PARAMETERS OID(개체 식별자) 요청을 실행합니다.

각 라우팅 도메인은 포트에서 별도로 구성되지만 이 OID는 단일 쿼리에서 모든 라우팅 도메인에 대한 매개 변수를 반환합니다.

오버리싱 드라이버는 다음 두 단계로 이 OID를 실행해야 합니다.

  1. Io는 필요한 버퍼 크기를 쿼리하고, NDIS_ISOLATION_PARAMETERS 구조체의 Header 멤버의 Size 멤버를 NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1 설정하여 OID 쿼리를 실행합니다. (아래 NDIS_STATUS_INVALID_LENGTH 참조하세요.)
  2. 필요한 크기의 InformationBuffer 를 사용하여 OID를 실행합니다.

OID 쿼리 요청이 성공적으로 완료되면 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에 버퍼에 대한 포인터가 포함됩니다. 이 버퍼에는 다음 데이터가 순서대로 포함됩니다.

  1. NDIS_ISOLATION_PARAMETERS 구조체

  2. 라우팅 도메인마다 하나씩 하나 이상의 NDIS_ROUTING_DOMAIN_ENTRY 구조체

  3. 라우팅 도메인별로 그룹화된 하나 이상의 NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY 구조체

각 NDIS_ROUTING_DOMAIN_ENTRY 구조에서 FirstIsolationInfoEntryOffset 멤버는 OID 정보 버퍼의 시작 부분(즉, NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버가 가리키는 버퍼의 시작 부분)부터 해당 라우팅 도메인에 대한 첫 번째 NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY 오프셋을 포함합니다. 목록에서 마지막 구조체의 NextIsolationInfoEntryOffset 멤버의 오프셋은 0입니다.

VM 네트워크 어댑터에 다중 테넌트 구성 매개 변수가 설정되지 않은 경우 네트워크 어댑터 미니포트 드라이버는 데이터를 설정합니다. QUERY_INFORMATION. Bytes NDIS_OID_REQUEST구조체 의 멤버를 0으로 만들고 NDIS_STATUS_SUCCESS 반환합니다. 이 경우 데이터 내의 데이터입니다 . QUERY_INFORMATION. InformationBuffer 멤버는 미니포트 드라이버에 의해 수정되지 않습니다.

설명

반환 상태 코드

VM 네트워크 어댑터 미니포트 드라이버는 이 OID 요청에 대해 다음 상태 코드 중 하나를 반환합니다.

상태 코드 Description

NDIS_STATUS_SUCCESS

OID 요청이 성공적으로 완료되었습니다.

NDIS_STATUS_INVALID_LENGTH

정보 버퍼의 길이가 너무 작아서 요청된 정보를 반환할 수 없습니다. VM 네트워크 어댑터 미니포트 드라이버는 데이터를 설정합니다. METHOD_INFORMATION. 필요한 최소 버퍼 크기(바이트)에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다.

NDIS_STATUS_FAILURE

다른 이유로 인해 요청이 실패했습니다.

요구 사항

Version

NDIS 6.40 이상에서 지원됩니다.

헤더

 Ntddndis.h(Ndis.h 포함)

추가 정보

NDIS_ISOLATION_PARAMETERS

NDIS_OID_REQUEST

NDIS_ROUTING_DOMAIN_ENTRY

NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY

NDIS_STATUS_ISOLATION_PARAMETERS_CHANGE