GET_VIRTUAL_DEVICE_DATA fonction de rappel (wdm.h)

  • Article

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 de contexte de la structure PCI_VIRTUALIZATION_INTERFACE pour l’interface.

[in] VirtualFunction

Valeur de base zéro qui spécifie la 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 de la VF.

[in] Offset

Décalage dans les données d’espace de configuration PCIe de la 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 retournée

La routine GetVirtualFunctionData retourne la longueur, en octets, des données de configuration PCIe qui ont été 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 , à ceci près qu’elle lit les données de configuration PCIe à partir d’une VF au lieu de la fonction physique (PF) d’un appareil.

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 qui s’exécute dans le système d’exploitation invité appelle la routine GetBusData .

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 (inclure Wdm.h)
IRQL IRQL <= APC_LEVEL

Voir aussi

PCI_VIRTUALIZATION_INTERFACE

GetBusData