Partager via


SRIOV_GET_DEVICE_LOCATION fonction de rappel (pcivirt.h)

Récupère des informations sur l’emplacement actuel de l’appareil PCI sur le bus, telles que le segment PCI, le bus, l’appareil et le numéro de fonction.

Syntaxe

SRIOV_GET_DEVICE_LOCATION SriovGetDeviceLocation;

void SriovGetDeviceLocation(
  [in]  PVOID Context,
  [in]  USHORT VfIndex,
  [out] PUINT16 SegmentNumber,
  [out] PUINT8 BusNumber,
  [out] PUINT8 FunctionNumber
)
{...}

Paramètres

[in] Context

Pointeur vers un contexte défini par le pilote.

[in] VfIndex

Index de base zéro du VF auquel cette opération de lecture s’applique.

[out] SegmentNumber

Pointeur vers une variable renseignée avec le numéro de segment actuel, qui décrit le groupe de bus PCI auxquels cet appareil est attaché.

[out] BusNumber

Pointeur vers une variable qui est renseignée avec le numéro de bus actuel, qui décrit le pci bus auquel cet appareil est attaché.

[out] FunctionNumber

Pointeur vers une variable qui est renseignée avec functionNumber, qui décrit plus en détail l’emplacement de ce bus que l’appareil peut trouver.

Valeur de retour

Aucun

Remarques

Cette fonction de rappel est implémentée par le pilote de fonction physique (PF). Il est appelé lorsque le système souhaite récupérer l’emplacement de l’appareil.

Le pilote PF inscrit son implémentation en définissant le membre GetDeviceLocation du SRIOV_DEVICE_INTERFACE_STANDARD, en configurant une structure WDF_QUERY_INTERFACE_CONFIG et en appelant WdfDeviceAddQueryInterface.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10
serveur minimum pris en charge Windows Server 2016
plateforme cible Windows
d’en-tête pcivirt.h
IRQL PASSIVE_LEVEL