ENABLE_VIRTUALIZATION funzione di callback (wdm.h)

Articolo
02/27/2024

La routine EnableVirtualization abilita o disabilita la virtualizzazione per un dispositivo PCI Express (PCIe) che supporta l'interfaccia sr-IOV (Single Root I/O Virtualization).

Sintassi

ENABLE_VIRTUALIZATION EnableVirtualization;

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

Parametri

[in, out] Context

Puntatore a informazioni di contesto specifiche dell'interfaccia. Il chiamante passa il valore passato come membro Context della struttura PCI_VIRTUALIZATION_INTERFACE per l'interfaccia.

[in] NumVFs

Numero di funzioni virtuali PCIe da abilitare per il dispositivo. La routine EnableVirtualization imposta il membro NumVFs della struttura PCIe SR-IOV Extended Capability sul valore del parametro NumVFs .

Se il parametro EnableVirtualization è FALSE, il parametro NumVFs deve essere impostato su zero.

[in] EnableVfMigration

Valore BOOLEAN che indica se la funzione di base I/O multi-root (MR-IOV) può eseguire di nuovo il provisioning dinamico della funzione fisica PCIe (PF) del dispositivo come VF in fase di esecuzione.

Questo parametro è applicabile solo ai dispositivi che supportano entrambe le interfacce SR-IOV e MR-IOV. Il driver deve impostare questo parametro su FALSE se il dispositivo supporta solo l'interfaccia SR-IOV e non l'interfaccia MR-IOV.

[in] EnableMigrationInterrupt

Valore BOOLEAN che indica se l'interrupt associato al file PF deve essere mascherato o non mascherato durante la migrazione VF.

Se i parametri EnableVfMigration sono FALSE, il driver deve anche impostare questo parametro su FALSE.

[in] EnableVirtualization

Valore BOOLEAN che indica se la virtualizzazione è abilitata nello spazio di configurazione PCIe del dispositivo. Se il parametro EnableVirtualization è TRUE, la routine EnableVirtualization imposta il bit VF Enable del campo PCIe SR-IOV Control. La routine EnableVirtualization cancella questo bit se il parametro EnableVirtualization è FALSE.

Valore restituito

La routine EnableVirtualization restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Operazione riuscita.
STATUS_INVALID_PARAMETER	Il parametro NumVFs è zero o è maggiore del valore del membro TotalVFs della struttura SR-IOV Extended Capability per il dispositivo.
STATUS_INVALID_DEVICE_STATE	La virtualizzazione è già abilitata nel dispositivo e il parametro EnableVirtualization è TRUE oppure la virtualizzazione è già disabilitata nel dispositivo e il parametro EnableVirtualization è FALSE.

Commenti

I driver chiamano la routine EnableVirtualization per configurare i campi Di capacità estesa SR-IOV nello spazio di configurazione PCIe. Questa chiamata abilita o disabilita la virtualizzazione nello spazio di configurazione e specifica il numero di macchine virtuali che devono essere esposte all'infrastruttura PCIe dal dispositivo.

La routine EnableVirtualization viene fornita dall'interfaccia GUID_PCI_VIRTUALIZATION_INTERFACE .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in Windows Server 2012 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h (include Wdm.h)
IRQL	IRQL <= DISPATCH_LEVEL

Vedi anche

PCI_VIRTUALIZATION_INTERFACE

Condividi tramite