ENABLE_VIRTUALIZATION función de devolución de llamada (wdm.h)

La rutina EnableVirtualization habilita o deshabilita la virtualización para un dispositivo PCI Express (PCIe) que admite la interfaz de virtualización de E/S raíz única (SR-IOV).

Sintaxis

ENABLE_VIRTUALIZATION EnableVirtualization;

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

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 de PCI_VIRTUALIZATION_INTERFACE para la interfaz.

[in] NumVFs

Número de funciones virtuales (VFs) pcIe que se van a habilitar para el dispositivo. La rutina EnableVirtualization establece el miembro NumVFs de la estructura pcIe SR-IOV extended Capability en el valor del parámetro NumVFs.

Si el parámetro enableVirtualization es FALSE, el parámetro NumVFs debe establecerse en cero.

[in] EnableVfMigration

Valor BOOLEAN que indica si la función base de virtualización de E/S multi root (MR-IOV) (BF) puede volver a aprovisionar dinámicamente la función física PCIe (PF) del dispositivo como VF en tiempo de ejecución.

Este parámetro solo es aplicable a los dispositivos que admiten las interfaces SR-IOV y MR-IOV. El controlador debe establecer este parámetro en FALSE si el dispositivo solo admite la interfaz SR-IOV y no la interfaz MR-IOV.

[in] EnableMigrationInterrupt

Valor BOOLEAN que indica si la interrupción asociada al PF se debe enmascarar o desenmascarar durante la migración de VF.

Si los parámetros EnableVfMigration se FALSE, el controlador también debe establecer este parámetro en FALSE.

[in] EnableVirtualization

Valor BOOLEAN que indica si la virtualización está habilitada en el espacio de configuración PCIe del dispositivo. Si el parámetro EnableVirtualization es TRUE, la rutina EnableVirtualization establece el bit Habilitar VF del campo PcIe SR-IOV Control. La rutina enableVirtualization borra este bit si el parámetro enableVirtualization es FALSE.

Valor devuelto

La rutina enableVirtualization devuelve uno de los siguientes valores NTSTATUS:

Observaciones

Los controladores llaman a la rutina enableVirtualization para configurar los campos de funcionalidad extendida de SR-IOV en el espacio de configuración PCIe. Esta llamada habilita o deshabilita la virtualización en el espacio de configuración y especifica el número de máquinas virtuales que el dispositivo debe exponer al tejido PCIe.

La rutina EnableVirtualization proporciona la interfaz GUID_PCI_VIRTUALIZATION_INTERFACE.

Requisitos

Consulte también

PCI_VIRTUALIZATION_INTERFACE