Función NdisMSetVirtualFunctionBusData (ndis.h)

Artículo
08/07/2023

Un controlador de minipuerto llama a la función NdisMSetVirtualFunctionBusData para escribir datos en el espacio de configuración PCI Express (PCIe) de una función virtual (VF) en el adaptador de red.

NotaNdisMGetVirtualFunctionBusData solo debe llamarlo el controlador de miniporte para la función física PCIe (PF) del adaptador de red.

Sintaxis

ULONG NdisMSetVirtualFunctionBusData(
  [in] NDIS_HANDLE            NdisMiniportHandle,
  [in] NDIS_SRIOV_FUNCTION_ID VFId,
  [in] PVOID                  Buffer,
  [in] ULONG                  Offset,
  [in] ULONG                  Length
);

Parámetros

[in] NdisMiniportHandle

Identificador de adaptador de red que NDIS pasó al parámetro MiniportAdapterHandle de MiniportInitializeEx.

[in] VFId

Identificador del VF en el que se escriben los datos en su espacio de configuración pci.

[in] Buffer

Puntero a un búfer que contiene los datos que se van a escribir en el espacio de configuración pci.

[in] Offset

Desplazamiento, en unidades de bytes, en el espacio de configuración PCI en el que se escriben los datos.

[in] Length

Longitud, en unidades de bytes, de los datos que se van a escribir.

Valor devuelto

NdisMSetVirtualFunctionBusData devuelve el número de bytes escritos en el espacio de configuración pci. Si se produce un error en la operación de escritura, NdisMSetVirtualFunctionBusData devuelve cero.

Comentarios

El controlador de minipuerto PF normalmente llama a NdisMSetVirtualFunctionBusData cuando controla una solicitud de método OID de OID_SRIOV_WRITE_VF_CONFIG_SPACE.
Sin embargo, el controlador puede llamar a esta función en cualquier momento después de habilitar la virtualización en el adaptador de red a través de una llamada a NdisMEnableVirtualization.

Para obtener más información sobre la comunicación backchannel dentro de la interfaz de virtualización de E/S raíz única (SR-IOV), consulte SR-IOV PF/VF Backchannel Communication.

Para obtener más información sobre la interfaz SR-IOV, vea Información general sobre la virtualización de E/S raíz única (SR-IOV).

Interacción con un controlador de bus virtual

Si un proveedor de hardware independiente (IHV) proporciona un controlador de bus virtual (VBD) como parte de su paquete de controladores SR-IOV, su controlador de miniporte no debe llamar a NdisMSetVirtualFunctionBusData. En su lugar, el controlador debe interactuar con VBD a través de un canal de comunicación privado y solicitar que el VBD llame a SetVirtualFunctionData. Esta función se expone desde la interfaz GUID_PCI_VIRTUALIZATION_INTERFACE compatible con el controlador de bus PCI subyacente.

El VBD que se ejecuta en el sistema operativo de administración de la partición primaria de Hyper-V puede consultar la interfaz de GUID_PCI_VIRTUALIZATION_INTERFACE mediante la emisión de una solicitud de IRP_MN_QUERY_INTERFACE a su objeto de dispositivo físico (PDO) en el bus PCI. Esta solicitud se debe realizar desde IRQL = PASSIVE_LEVEL. En esta solicitud, el controlador debe establecer el parámetro InterfaceType en GUID_PCI_VIRTUALIZATION_INTERFACE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Ninguno compatible, compatible con NDIS 6.30 y versiones posteriores.
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL