SRIOV_GET_DEVICE_LOCATION Rückruffunktion (pcivirt.h)

Artikel
02/26/2024

Ruft Informationen zum aktuellen Standort des PCI-Geräts auf dem Bus ab, z. B. PCI-Segment, Bus, Gerät und Funktionsnummer.

Syntax

SRIOV_GET_DEVICE_LOCATION SriovGetDeviceLocation;

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

Parameter

[in] Context

Ein Zeiger auf einen vom Treiber definierten Kontext.

[in] VfIndex

Ein nullbasierter Index des VF, auf den dieser Lesevorgang angewendet wird.

[out] SegmentNumber

Ein Zeiger auf eine Variable, die mit der aktuellen Segmentnummer ausgefüllt ist, die die Gruppe der PCI-Busse beschreibt, an die dieses Gerät angefügt ist.

[out] BusNumber

Ein Zeiger auf eine Variable, die mit der aktuellen Busnummer gefüllt ist, die beschreibt, an welchen PCI-Bus dieses Gerät angeschlossen ist.

[out] FunctionNumber

Ein Zeiger auf eine Variable, die mit der FunctionNumber ausgefüllt ist, die weiter beschreibt, wo sich das Gerät in diesem Bus befindet.

Rückgabewert

Keine

Bemerkungen

Diese Rückruffunktion wird vom Treiber für die physische Funktion (PF) implementiert. Sie wird aufgerufen, wenn das System den Gerätestandort abrufen möchte.

Der PF-Treiber registriert seine Implementierung, indem er den GetDeviceLocation-Member des SRIOV_DEVICE_INTERFACE_STANDARD festlegt, eine WDF_QUERY_INTERFACE_CONFIG-Struktur konfiguriert und WdfDeviceAddQueryInterface aufruft.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
Kopfzeile	pcivirt.h
IRQL	PASSIVE_LEVEL

Freigeben über