SRIOV_QUERY_VF_LUID Rückruffunktion (pcivirt.h)

Artikel
02/07/2025

Ruft den lokalen eindeutigen Bezeichner des PCI Express SR-IOV Virtual Function (VF) ab.

Syntax

SRIOV_QUERY_VF_LUID SriovQueryVfLuid;

NTSTATUS SriovQueryVfLuid(
  [in]  PVOID Context,
  [in]  USHORT VfIndex,
  [out] PLUID Luid
)
{...}

Parameter

[in] Context

Ein Zeiger auf einen vom Treiber definierten Kontext.

[in] VfIndex

Ein nullbasierter Index des VF, der abgefragt wird.

[out] Luid

Ein Zeiger auf den lokalen eindeutigen Bezeichner des SR_IOV Geräts, das die Schnittstelle implementiert.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Geben Sie andernfalls einen geeigneten NTSTATUS- Fehlercode zurück.

Bemerkungen

Diese Rückruffunktion wird vom PF-Treiber (Physical Function) implementiert. Es wird aufgerufen, wenn das System den Bezeichner einer bestimmten virtuellen Funktion abrufen möchte.

Der PF-Treiber registriert seine Implementierung, indem das QueryLuid Member der SRIOV_DEVICE_INTERFACE_STANDARD_2 festgelegt, eine WDF_QUERY_INTERFACE_CONFIG Struktur konfiguriert und WdfDeviceAddQueryInterfaceaufgerufen wird.

Hier ist eine Beispielimplementierung dieser Rückruffunktion. Der PF-Treiber generiert einen eindeutigen Bezeichner, indem ZwAllocateLocallyUniqueId aufgerufen und im Gerätekontext gespeichert wird.


NTSTATUS
Virtualization_QueryLuid (
    _In_        PVOID             Context,
    _Out_       PLUID             Luid
    )
{
    PDEVICE_CONTEXT deviceContext;

    PAGED_CODE();

    deviceContext = (PDEVICE_CONTEXT)Context;
    *Luid = deviceContext->Luid;

    return STATUS_SUCCESS;
}

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Header-	pcivirt.h

Freigeben über