GET_VIRTUAL_DEVICE_DATA fonction de rappel (wdm.h)
La routine GetVirtualFunctionData lit les données de 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
GET_VIRTUAL_DEVICE_DATA GetVirtualDeviceData;
ULONG GetVirtualDeviceData(
[in, out] PVOID Context,
[in] USHORT VirtualFunction,
[out] 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 de l’interface.
[in] VirtualFunction
Valeur de base zéro qui spécifie la valeur VF sur l’appareil à partir de laquelle les données doivent être lues.
[out] Buffer
Pointeur vers la mémoire tampon qui contient les informations de configuration lues à partir de l’espace de configuration PCIe du VF.
[in] Offset
Décalage dans les données de l’espace de configuration PCIe du VF. Ce membre spécifie l’emplacement de début de cette opération de lecture.
[in] Length
Longueur, en octets, des données à lire.
Valeur de retour
La routine GetVirtualFunctionData retourne la longueur, en octets, des données de configuration PCIe lues après une opération de lecture réussie. Si l’opération de lecture échoue, la routine retourne zéro.
Remarques
La routine GetVirtualFunctionData ressemble à la routine GetBusData, sauf qu’elle lit les données de configuration PCIe à partir d’une machine virtuelle au lieu de la fonction physique d’un appareil (PF).
La routine GetVirtualFunctionData est fournie par l’interface GUID_PCI_VIRTUALIZATION_INTERFACE. La routine GetBusData est fournie par l’interface GUID_BUS_INTERFACE_STANDARD.
La pile de virtualisation appelle GetVirtualFunctionData lorsqu’un pilote en cours d’exécution dans le système d’exploitation invité appelle la routine GetBusData.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge dans Windows Server 2012 et versions ultérieures de Windows. |
| plateforme cible | Bureau |
| d’en-tête | wdm.h (include Wdm.h) |
| IRQL | IRQL <= APC_LEVEL |