SRIOV_QUERY_VF_LUID funzione di callback (pcivirt.h)

Articolo
02/07/2025

Ottiene l'identificatore univoco locale della funzione virtuale VF (PCI Express SR-IOV Virtual Function).

Sintassi

SRIOV_QUERY_VF_LUID SriovQueryVfLuid;

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

Parametri

[in] Context

Puntatore a un contesto definito dal driver.

[in] VfIndex

Indice in base zero dell'oggetto VF su cui viene eseguita una query.

[out] Luid

Puntatore all'identificatore univoco locale del dispositivo SR_IOV che implementa l'interfaccia.

Valore restituito

Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituire un NTSTATUS codice di errore appropriato.

Osservazioni

Questa funzione di callback viene implementata dal driver pf (Physical Function). Viene richiamato quando il sistema vuole ottenere l'identificatore di una funzione virtuale specifica.

Il driver PF registra l'implementazione impostando il membro QueryLuid del SRIOV_DEVICE_INTERFACE_STANDARD_2, configurando una struttura WDF_QUERY_INTERFACE_CONFIG e chiamando WdfDeviceAddQueryInterface.

Di seguito è riportato un esempio di implementazione di questa funzione di callback. Il driver PF genera un identificatore univoco chiamando ZwAllocateLocallyUniqueId e lo archivia nel contesto del dispositivo.


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

    PAGED_CODE();

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

    return STATUS_SUCCESS;
}

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10
server minimo supportato	Windows Server 2016
piattaforma di destinazione	Finestre
intestazione	pcivirt.h

Condividi tramite