ENABLE_VIRTUALIZATION função de retorno de chamada (wdm.h)

  • Artigo

A rotina EnableVirtualization habilita ou desabilita a virtualização para um dispositivo PCI Express (PCIe) que dá suporte à interface de virtualização de E/S raiz única (SR-IOV).

Sintaxe

ENABLE_VIRTUALIZATION EnableVirtualization;

NTSTATUS EnableVirtualization(
  [in, out] PVOID Context,
  [in]      UINT16 NumVFs,
  [in]      BOOLEAN EnableVfMigration,
  [in]      BOOLEAN EnableMigrationInterrupt,
  [in]      BOOLEAN EnableVirtualization
)
{...}

Parâmetros

[in, out] Context

Um ponteiro para informações de contexto específicas da interface. O chamador passa o valor que é passado como o membro Context da estrutura PCI_VIRTUALIZATION_INTERFACE para a interface.

[in] NumVFs

O número de VFs (funções virtuais) PCIe que devem ser habilitadas para o dispositivo. A rotina EnableVirtualization define o membro NumVFs da estrutura de Funcionalidade Estendida SR-IOV da PCIe como o valor do parâmetro NumVFs .

Se o parâmetro EnableVirtualization for FALSE, o parâmetro NumVFs deverá ser definido como zero.

[in] EnableVfMigration

Um valor BOOLEAN que indica se a função base de E/S (MR-IOV) de várias raizes pode reprovisionar dinamicamente a função física PCIe (PF) do dispositivo como uma VF em tempo de execução.

Esse parâmetro só é aplicável a dispositivos que dão suporte às interfaces SR-IOV e MR-IOV. O driver deve definir esse parâmetro como FALSE se o dispositivo der suporte apenas à interface SR-IOV e não à interface MR-IOV.

[in] EnableMigrationInterrupt

Um valor BOOLEAN que indica se a interrupção associada ao PF deve ser mascarada ou desmascarada durante a migração de VF.

Se os parâmetros EnableVfMigration forem FALSE, o driver também deverá definir esse parâmetro como FALSE.

[in] EnableVirtualization

Um valor BOOLEAN que indica se a virtualização está habilitada no espaço de configuração PCIe do dispositivo. Se o parâmetro EnableVirtualization for TRUE, a rotina EnableVirtualization definirá o bit Habilitar VF do campo Controle SR-IOV pcie. A rotina EnableVirtualization limpará esse bit se o parâmetro EnableVirtualization for FALSE.

Retornar valor

A rotina EnableVirtualization retorna um dos seguintes valores NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS A operação foi concluída com sucesso.
STATUS_INVALID_PARAMETER O parâmetro NumVFs é zero ou é maior que o valor do membro TotalVFs da estrutura de Capacidade Estendida SR-IOV para o dispositivo.
STATUS_INVALID_DEVICE_STATE A virtualização já está habilitada no dispositivo e o parâmetro EnableVirtualization é TRUE ou a virtualização já está desabilitada no dispositivo e o parâmetro EnableVirtualization é FALSE.

Comentários

Os drivers chamam a rotina EnableVirtualization para configurar os campos de Funcionalidade Estendida SR-IOV no espaço de configuração PCIe. Essa chamada habilita ou desabilita a virtualização no espaço de configuração e especifica o número de VFs que devem ser expostos à malha PCIe pelo dispositivo.

A rotina EnableVirtualization é fornecida pela interface GUID_PCI_VIRTUALIZATION_INTERFACE .

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte em Windows Server 2012 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (inclua Wdm.h)
IRQL IRQL <= DISPATCH_LEVEL

Confira também

PCI_VIRTUALIZATION_INTERFACE