OID_GEN_ISOLATION_PARAMETERS
NDIS 및 오버리싱 드라이버는 VM 네트워크 어댑터의 포트에 설정된 다중 테넌트 구성(격리) 매개 변수를 얻기 위해 OID_GEN_ISOLATION_PARAMETERS OID(개체 식별자) 요청을 실행합니다.
각 라우팅 도메인은 포트에서 별도로 구성되지만 이 OID는 단일 쿼리에서 모든 라우팅 도메인에 대한 매개 변수를 반환합니다.
오버리싱 드라이버는 다음 두 단계로 이 OID를 실행해야 합니다.
- Io는 필요한 버퍼 크기를 쿼리하고, NDIS_ISOLATION_PARAMETERS 구조체의 Header 멤버의 Size 멤버를 NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1 설정하여 OID 쿼리를 실행합니다. (아래 NDIS_STATUS_INVALID_LENGTH 참조하세요.)
- 필요한 크기의 InformationBuffer 를 사용하여 OID를 실행합니다.
OID 쿼리 요청이 성공적으로 완료되면 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에 버퍼에 대한 포인터가 포함됩니다. 이 버퍼에는 다음 데이터가 순서대로 포함됩니다.
라우팅 도메인마다 하나씩 하나 이상의 NDIS_ROUTING_DOMAIN_ENTRY 구조체
라우팅 도메인별로 그룹화된 하나 이상의 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 포함) |