SRIOV_READ_BLOCK funzione di callback (pcivirt.h)

Articolo
02/07/2025

Legge i dati dal blocco di configurazione specificato di una funzione virtuale VF (PCI Express SR-IOV Virtual Function).

Sintassi

SRIOV_READ_BLOCK SriovReadBlock;

NTSTATUS SriovReadBlock(
  [in]  PVOID Context,
  [in]  USHORT VfIndex,
  [in]  ULONG BlockId,
  [out] PVOID Buffer,
  [in]  ULONG Length
)
{...}

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.

[in] BlockId

Numero che identifica il blocco da leggere. Questa operazione viene definita dal provider del driver PF.

[out] Buffer

Puntatore a un buffer che riceve i dati letti dallo spazio di configurazione di VF.

[in] Length

Lunghezza in byte di questa operazione di lettura. Non deve essere maggiore di VPCI_MAX_READ_WRITE_BLOCK_SIZE definito in Pcivirt.h.

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 leggere un blocco di configurazione per una delle relative macchine virtuali.

Il driver PF registra l'implementazione impostando il membro ReadVfConfigBlock 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