SET_VIRTUAL_DEVICE_DATA fonction de rappel (wdm.h)
La routine SetVirtualFunctionData écrit des données dans l’espace de configuration PCI Express (PCIe) d’une fonction virtuelle (VF) sur un appareil qui prend en charge l’interface de virtualisation d’E/S racine unique (SR-IOV).
Syntaxe
SET_VIRTUAL_DEVICE_DATA SetVirtualDeviceData;
ULONG SetVirtualDeviceData(
[in, out] PVOID Context,
[in] USHORT VirtualFunction,
[in] PVOID Buffer,
[in] ULONG Offset,
[in] ULONG Length
)
{...}
Paramètres
[in, out] Context
Pointeur vers des informations de contexte spécifiques à l’interface. L’appelant transmet la valeur qui est passée en tant que membre context de la structure PCI_VIRTUALIZATION_INTERFACE pour l’interface.
[in] VirtualFunction
Valeur de base zéro qui spécifie le VF sur l’appareil à partir duquel les données doivent être écrites.
[in] Buffer
Pointeur vers la mémoire tampon qui contient les informations de configuration à écrire dans l’espace de configuration PCIe de la VF.
[in] Offset
Décalage dans les données de l’espace de configuration PCIe de la VF. Ce membre spécifie où cette opération d’écriture commence.
[in] Length
Longueur, en octets, des données à écrire.
Valeur retournée
La routine *SetVirtualFunctionData retourne la longueur, en octets, des données de configuration PCIe qui ont été écrites après une opération d’écriture réussie. Si l’opération d’écriture échoue, la routine retourne zéro.
Remarques
La routine *SetVirtualFunctionData est similaire à la routine SetBusData , à ceci près qu’elle écrit les données de configuration PCIe dans une VF plutôt que dans la fonction physique (PF) d’un appareil.
La routine *SetVirtualFunctionData est fournie par l’interface GUID_PCI_VIRTUALIZATION_INTERFACE . La routine SetBusData est fournie par l’interface GUID_BUS_INTERFACE_STANDARD .
La pile de virtualisation appelle *SetVirtualFunctionData lorsqu’un pilote qui s’exécute dans le système d’exploitation invité appelle la routine SetBusData .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge dans Windows Server 2012 et versions ultérieures de Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wdm.h (include Wdm.h) |
| IRQL | IRQL <= APC_LEVEL |