Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La rutina de GetResources devuelve los recursos que requiere la función física de PCI Express (PCIe) (PF) para habilitar la virtualización en un dispositivo que admita la interfaz de virtualización de E/S raíz única (SR-IOV).
Sintaxis
GET_VIRTUAL_DEVICE_RESOURCES GetVirtualDeviceResources;
void GetVirtualDeviceResources(
[in, out] PVOID Context,
[out] PUINT8 CapturedBusNumbers
)
{...}
Parámetros
[in, out] Context
Puntero a información de contexto específica de la interfaz. El autor de la llamada pasa el valor que se pasa como el miembro Context de la estructura PCI_VIRTUALIZATION_INTERFACE de la interfaz.
[out] CapturedBusNumbers
Puntero a una variable proporcionada por el autor de la llamada en la que esta rutina devuelve un valor UINT8. Este valor especifica el número de buses PCIe capturados para su uso por el SR-IOV PF del dispositivo.
Valor devuelto
Ninguno
Observaciones
Un dispositivo PCIe normalmente consume recursos en un solo bus PCI. El controlador PCI asigna un dispositivo a un bus PCI escribiendo el número de autobús en el registro del número de autobús secundario y el registro de número de autobús subordinado en el puerto del puente ascendente. Este puerto es un puente PCI a PCI dentro de un puerto raíz PCIe o un puerto de conmutador PCIe.
Un dispositivo que admita la interfaz SR-IOV puede crear más funciones virtuales de las que se pueden alojar en el bus PCI en el que está conectado el dispositivo. En estas situaciones, el puerto del puente ascendente debe configurarse para capturar uno o varios buses PCI sin usar. Para ello, escriba un valor mayor en el registro de número de bus subordinado del puerto.
Un dispositivo que admita la interfaz SR-IOV debe capturar buses PCI si se cumple al menos uno de los siguientes elementos:
El dispositivo tiene más de ocho funciones totales (FF y VFs) y el dispositivo no admite la opción Interpretación de enrutamiento alternativo (ARI) de la especificación PCI Express 3.0.
El dispositivo admite ARI y tiene más de ocho funciones totales, pero el puerto de puente ascendente no admite ARI.
El dispositivo admite ARI y tiene más de 256 funciones y el puerto de puente ascendente admite ARI.
Independientemente de la compatibilidad con ARI, cada bus capturado puede admitir 256 funciones.
Si el dispositivo necesita más identificadores de solicitante PCIe (RID) para habilitar todas sus máquinas virtuales, el controlador de bus PCI hace lo siguiente:
Escribe el número de autobús del dispositivo en el registro del número de autobús secundario pcIe.
Escribe un valor que es mayor que el número de autobús del dispositivo en el registro de número de autobús subordinado pcIe.
La diferencia entre estos dos valores de registro representa el número de números de bus capturados.
La interfaz GUID_PCI_VIRTUALIZATION_INTERFACE proporciona la rutina GetResources.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con Windows Server 2012 y versiones posteriores de Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h (incluya Wdm.h) |
| irQL | PASSIVE_LEVEL |