SET_VIRTUAL_DEVICE_DATA fonction de rappel (wdm.h)

Article
02/29/2024

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

Voir aussi

SetBusData

PCI_VIRTUALIZATION_INTERFACE

Partager via