ENABLE_VIRTUALIZATION funzione di callback (wdm.h)
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 |