Función NdisGetHypervisorInfo (ndis.h)

  • Artículo
Importante  

A partir de Windows 10 versión 1703, NdisGetHypervisorInfo está en desuso y no se debe usar. Se recomienda que los controladores se desplacen de él, ya que es posible que no esté disponible en versiones futuras del sistema operativo.

En su lugar, los controladores deben seguir las instrucciones de un hipervisor para consultar la presencia y las funcionalidades del hipervisor. Por ejemplo, las instrucciones de Hyper-V se documentan en la Especificación funcional de nivel superior.

La función NdisGetHypervisorInfo devuelve información sobre el hipervisor que está presente en el sistema.

Sintaxis

NDIS_STATUS NdisGetHypervisorInfo(
  [in, out] PNDIS_HYPERVISOR_INFO HypervisorInfo
);

Parámetros

[in, out] HypervisorInfo

Puntero a una estructura de NDIS_HYPERVISOR_INFO asignada por el autor de la llamada que contiene información sobre el hipervisor que está presente en el sistema.

Valor devuelto

NdisGetHypervisorInfo puede devolver uno de los siguientes valores de estado:

Código devuelto Descripción
NDIS_STATUS_SUCCESS
 La operación se ha completado correctamente.
NDIS_STATUS_BUFFER_TOO_SHORT
 El tamaño del búfer de parámetros de entrada era demasiado pequeño.

Comentarios

Los controladores de miniporte NDIS llaman a la función NdisGetHypervisorInfo para determinar si un hipervisor está presente en el sistema.

Cuando la función NdisGetHypervisorInfo devuelve, el parámetro HypervisorInfo contiene un puntero a una estructura de NDIS_HYPERVISOR_INFO . Esta estructura contiene información sobre si un hipervisor está presente, junto con el tipo de partición desde el que se llamó a esta función. La estructura NDIS_HYPERVISOR_INFO proporciona esta información de la siguiente manera:

  • Si hay un hipervisor presente, la marca NDIS_HYPERVISOR_INFO_FLAG_HYPERVISOR_PRESENT se establece en el miembro Flags .
  • Si el hipervisor de Microsoft está presente, el miembro PartitionType se establece en uno de los valores siguientes:
    • Si se llamó a la función NdisGetHypervisorInfo desde el sistema operativo de administración que se ejecuta en la partición primaria de Hyper-V, el miembro PartitionType se establece en NdisHypervisorPartitionTypeMsHvParent.
    • Si se llamó a la función NdisGetHypervisorInfo desde el sistema operativo invitado que se ejecuta en la partición secundaria de Hyper-V, el miembro PartitionType se establece en NdisHypervisorPartitionMsHvChild.
  • Si el hipervisor de otro proveedor está presente, el miembro PartitionType se establece en NdisHypervisorPartitionTypeUnknown.
Nota Un controlador debe inicializar el miembro Header de la estructura NDIS_HYPERVISOR_INFO antes de llamar a la función NdisGetHypervisorInfo .
 

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con NDIS 6.0 y versiones posteriores.
Plataforma de destino Universal
Encabezado ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL

Consulte también

NDIS_HYPERVISOR_INFO