SRIOV_GET_DEVICE_LOCATION funzione di callback (pcivirt.h)

Articolo
02/07/2025

Recupera informazioni sulla posizione corrente del dispositivo PCI sul bus, ad esempio PCI Segmento, Bus, Dispositivo e Numero funzione.

Sintassi

SRIOV_GET_DEVICE_LOCATION SriovGetDeviceLocation;

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

Parametri

[in] Context

Puntatore a un contesto definito dal driver.

[in] VfIndex

Indice in base zero dell'oggetto VF a cui si applica questa operazione di lettura.

[out] SegmentNumber

Puntatore a una variabile compilata con il numero di segmento corrente, che descrive il gruppo di bus PCI a cui è collegato il dispositivo.

[out] BusNumber

Puntatore a una variabile compilata con il numero di bus corrente, che descrive il bus PCI a cui è collegato il dispositivo.

[out] FunctionNumber

Puntatore a una variabile compilata con FunctionNumber, che descrive ulteriormente dove si trova il dispositivo nel bus.

Valore restituito

Nessuno

Osservazioni

Questa funzione di callback viene implementata dal driver pf (Physical Function). Viene richiamato quando il sistema vuole recuperare la posizione del dispositivo.

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

Fabbisogno

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

Condividi tramite