Função NdisGetHypervisorInfo (ndis.h)
A partir do Windows 10 Versão 1703, o NdisGetHypervisorInfo é preterido e não deve ser usado. Os drivers são incentivados a se afastar dele, pois podem não estar disponíveis em versões futuras do sistema operacional.
Em vez disso, os drivers devem seguir as instruções de um hipervisor para consultar a presença e os recursos do hipervisor. Por exemplo, as instruções do Hyper-V são documentadas no de Especificação Funcional doTop-Level.
A função NdisGetHypervisorInfo retorna informações sobre o hipervisor presente no sistema.
Sintaxe
NDIS_STATUS NdisGetHypervisorInfo(
[in, out] PNDIS_HYPERVISOR_INFO HypervisorInfo
);
Parâmetros
[in, out] HypervisorInfo
Um ponteiro para uma estrutura de NDIS_HYPERVISOR_INFO alocada por chamador que contém informações sobre o hipervisor presente no sistema.
Valor de retorno
NdisGetHypervisorInfo pode retornar um dos seguintes valores de status:
| Código de retorno | Descrição |
|---|---|
|
A operação foi concluída com êxito. |
|
O tamanho do buffer de parâmetro de entrada era muito pequeno. |
Observações
Os drivers de miniporto NDIS chamam a função NdisGetHypervisorInfo para determinar se um hipervisor está presente no sistema.
Quando a função NdisGetHypervisorInfo retorna, o parâmetro hypervisorInfo contém um ponteiro para uma estrutura NDIS_HYPERVISOR_INFO. Essa estrutura contém informações sobre se um hipervisor está presente, juntamente com o tipo de partição do qual essa função foi chamada. A estrutura NDIS_HYPERVISOR_INFO fornece essas informações da seguinte maneira:
- Se um hipervisor estiver presente, o sinalizador de NDIS_HYPERVISOR_INFO_FLAG_HYPERVISOR_PRESENT será definido no membro sinalizadores do.
-
Se o hipervisor da Microsoft estiver presente, o membro PartitionType será definido como um dos seguintes valores:
- Se a função NdisGetHypervisorInfo tiver sido chamada do sistema operacional de gerenciamento executado na partição pai Hyper-V, o membro partitionType será definido como NdisHypervisorPartitionTypeMsHvParent.
- Se a função NdisGetHypervisorInfo foi chamada do sistema operacional convidado executado na partição filho Hyper-V, o membro partitionType será definido como NdisHypervisorPartitionMsHvChild.
- Se o hipervisor de outro fornecedor estiver presente, o membro partitionType será definido como NdisHypervisorPartitionTypeUnknown.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte no NDIS 6.0 e posterior. |
| da Plataforma de Destino | Universal |
| cabeçalho | ndis.h (inclua Ndis.h) |
| biblioteca | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |