ENABLE_VIRTUALIZATION funzione di callback (wdm.h)

Articolo
02/07/2025

La routine EnableVirtualization abilita o disabilita la virtualizzazione per un dispositivo PCI Express (PCIe) che supporta la singola interfaccia di I/O radice (SR-IOV).

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 che devono essere abilitate 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 di I/O multi-radice (MR-IOV) può eseguire dinamicamente il provisioning della funzione fisica PCIe (PF) del dispositivo come VF in fase di esecuzione.

Questo parametro è applicabile solo ai dispositivi che supportano sia le interfacce SR-IOV che 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 di EnableVfMigration è 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 completata correttamente.
STATUS_INVALID_PARAMETER	Il parametro NumVFs è pari a zero o è maggiore del valore del membro TotalVFs della struttura SR-IOV funzionalità estesa per il dispositivo.
STATUS_INVALID_DEVICE_STATE	La virtualizzazione è già abilitata nel dispositivo e il parametro EnableVirtualization è TRUEo la virtualizzazione è già disabilitata nel dispositivo e il parametro EnableVirtualization è FALSE.

Osservazioni

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

La routine EnableVirtualization viene fornita dall'interfaccia GUID_PCI_VIRTUALIZATION_INTERFACE.

Fabbisogno

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

Vedere anche

PCI_VIRTUALIZATION_INTERFACE

Condividi tramite