Função NdisGetHypervisorInfo (ndis.h)
A partir do Windows 10 versão 1703, NdisGetHypervisorInfo foi preterido e não deve ser usado. Os drivers são incentivados a se afastar dele, pois ele pode não estar disponível 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 as funcionalidades do hipervisor. Por exemplo, as instruções do Hyper-V estão documentadas na Especificação Funcional de Nível Superior.
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 pelo chamador que contém informações sobre o hipervisor presente no sistema.
Retornar valor
NdisGetHypervisorInfo pode retornar um dos seguintes valores de status:
| Código de retorno | Descrição |
|---|---|
|
A operação foi concluída com sucesso. |
|
O tamanho do buffer de parâmetro de entrada era muito pequeno. |
Comentários
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 NDIS_HYPERVISOR_INFO_FLAG_HYPERVISOR_PRESENT será definido no membro Flags .
-
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 do Hyper-V, o membro PartitionType será definido como NdisHypervisorPartitionTypeMsHvParent.
- Se a função NdisGetHypervisorInfo tiver sido chamada do sistema operacional convidado que é executado na partição filho do 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 |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.0 e posterior. |
| Plataforma de Destino | Universal |
| Cabeçalho | ndis.h (inclua Ndis.h) |
| Biblioteca | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |