GET_VIRTUAL_DEVICE_RESOURCES funzione di callback (wdm.h)

La routine GetResources restituisce le risorse richieste dalla funzione fisica PCI Express (PCIe) per abilitare la virtualizzazione in un dispositivo che supporta l'interfaccia SR-IOV (Single Root I/O Virtualization).

Sintassi

GET_VIRTUAL_DEVICE_RESOURCES GetVirtualDeviceResources;

void GetVirtualDeviceResources(
  [in, out] PVOID Context,
  [out]     PUINT8 CapturedBusNumbers
)
{...}

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.

[out] CapturedBusNumbers

Puntatore a una variabile fornita dal chiamante in cui questa routine restituisce un valore UINT8. Questo valore specifica il numero di bus PCIe acquisiti per l'uso dal PF SR-IOV del dispositivo.

Valore restituito

nessuno

Osservazioni

Un dispositivo PCIe utilizza in genere le risorse in un singolo bus PCI. Il driver PCI assegna un dispositivo a un bus PCI scrivendo il numero del bus nel registro dei numeri del bus secondario e nel registro dei numeri del bus subordinato nella porta del bridge upstream. Questa porta è un bridge PCI-to-PCI all'interno di una porta radice PCIe o di una porta del commutatore PCIe.

Un dispositivo che supporta l'interfaccia SR-IOV può creare più funzioni virtuali di quanto possa essere supportato nel bus PCI in cui è connesso il dispositivo. In queste situazioni, la porta del bridge upstream deve essere configurata per acquisire uno o più bus PCI inutilizzati. Questa operazione viene eseguita scrivendo un valore maggiore nel registro dei numeri del bus subordinato della porta.

Un dispositivo che supporta l'interfaccia SR-IOV deve acquisire bus PCI se almeno uno dei seguenti è vero:

• Il dispositivo ha più di otto funzioni totali (PFS e VFS) e il dispositivo non supporta l'opzione ARI (Alternative Routing Interpretation) della specifica PCI Express 3.0.

• Il dispositivo supporta ARI e ha più di otto funzioni totali, ma la porta del bridge upstream non supporta ARI.

• Il dispositivo supporta ARI e ha più di 256 funzioni e la porta del bridge upstream supporta ARI.

Indipendentemente dal supporto ARI, ogni bus acquisito può supportare 256 funzioni.

Se il dispositivo necessita di più ID del richiedente PCIe per abilitare tutte le VFS, il driver del bus PCI esegue le operazioni seguenti:

1. Scrive il numero del bus del dispositivo nel registro dei numeri del bus secondario PCIe.

2. Scrive un valore maggiore del numero del bus del dispositivo nel registro dei numeri del bus subordinato PCIe.

La differenza tra questi due valori di registro rappresenta il numero di numeri di bus acquisiti.

La routine GetResources viene fornita dall'interfaccia GUID_PCI_VIRTUALIZATION_INTERFACE .

Requisiti

Vedi anche

PCI_VIRTUALIZATION_INTERFACE