SRIOV_QUERY_LUID Rückruffunktion (pcivirt.h)

Artikel
02/26/2024

Ruft den lokalen eindeutigen Bezeichner des SR-IOV-Geräts ab.

Syntax

SRIOV_QUERY_LUID SriovQueryLuid;

NTSTATUS SriovQueryLuid(
  [in]  PVOID Context,
  [out] PLUID Luid
)
{...}

Parameter

[in] Context

Ein Zeiger auf einen vom Treiber definierten Kontext.

[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. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

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

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

Hier sehen Sie ein Beispiel für die Implementierung dieser Rückruffunktion. Der PF-Treiber generiert einen eindeutigen Bezeichner, indem er ZwAllocateLocallyUniqueId aufruft und im Gerätekontext speichert.


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
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
Kopfzeile	pcivirt.h
IRQL	PASSIVE_LEVEL

Freigeben über