OID_GEN_ISOLATION_PARAMETERS
Los controladores NDIS y los controladores excesivos emiten una solicitud de identificador de objeto (OID) de OID_GEN_ISOLATION_PARAMETERS para obtener los parámetros de configuración multiinquilino (aislamiento) que se establecen en el puerto de un adaptador de red de máquina virtual.
Aunque cada dominio de enrutamiento se configura por separado en el puerto, este OID devuelve parámetros para todos los dominios de enrutamiento en una sola consulta.
Un controlador de sobreaprovisionamiento debe emitir este OID en dos pasos:
- Io consulta el tamaño de búfer necesario, emita la consulta OID con el miembro Size del miembro Header de la estructura de NDIS_ISOLATION_PARAMETERS establecida en NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1. (Consulte NDIS_STATUS_INVALID_LENGTH a continuación).
- Emita el OID con informationBuffer del tamaño necesario.
Si la solicitud de consulta OID se completa correctamente, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a un búfer. Este búfer contiene los datos siguientes, en orden:
Una estructura de NDIS_ISOLATION_PARAMETERS
Una o varias estructuras de NDIS_ROUTING_DOMAIN_ENTRY , una para cada dominio de enrutamiento
Una o varias estructuras de NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY , agrupadas por dominio de enrutamiento
En cada estructura NDIS_ROUTING_DOMAIN_ENTRY , el miembro FirstIsolationInfoEntryOffset contiene el desplazamiento desde el principio del búfer de información de OID (es decir, el principio del búfer al que apunta el miembro InformationBuffer de la estructura NDIS_OID_REQUEST ) al primer NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY para ese dominio de enrutamiento. El desplazamiento del miembro NextIsolationInfoEntryOffset de la última estructura de la lista es cero.
Si no se establecen parámetros de configuración multiinquilino en el adaptador de red de la máquina virtual, el controlador de miniporte del adaptador de red establece data . QUERY_INFORMATION. BytesEscrito miembro de la estructura de NDIS_OID_REQUEST en cero y devuelve NDIS_STATUS_SUCCESS. En este caso, los datos dentro de DATA. QUERY_INFORMATION. El controlador de miniporte no modifica el miembro InformationBuffer.
Observaciones
Códigos de estado de devolución
El controlador de miniporte del adaptador de red de máquina virtual devuelve uno de los siguientes códigos de estado para esta solicitud de OID:
| Código de estado | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud de OID se completó correctamente. |
NDIS_STATUS_INVALID_LENGTH |
La longitud del búfer de información es demasiado pequeña para devolver la información solicitada. El controlador de miniporte del adaptador de red de la máquina virtual establece data . METHOD_INFORMATION. BytesNeeded miembro de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer, en bytes, necesario. |
NDIS_STATUS_FAILURE |
Error en la solicitud por otros motivos. |
Requisitos
Versión |
Compatible con NDIS 6.40 y versiones posteriores. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |