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, le numéro d’appareil et 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 de la VF à laquelle 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 remplie avec le numéro de bus actuel, qui décrit le bus PCI auquel cet appareil est attaché.

[out] FunctionNumber

Pointeur vers une variable renseignée avec functionnumber, qui décrit plus en détail où se trouve l’appareil dans ce bus.

Valeur de retour

None

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 enregistre 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
En-tête	pcivirt.h
IRQL	PASSIVE_LEVEL