Função NdisGetHypervisorInfo (ndis.h)

  • Artigo
Importante  

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
NDIS_STATUS_SUCCESS
 A operação foi concluída com sucesso.
NDIS_STATUS_BUFFER_TOO_SHORT
 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.
Nota Um driver deve inicializar o membro Header da estrutura NDIS_HYPERVISOR_INFO antes de chamar a função NdisGetHypervisorInfo .
 

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

Confira também

NDIS_HYPERVISOR_INFO