SRIOV_READ_BLOCK funzione di callback (pcivirt.h)

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

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 del VF a cui si applica questa operazione di lettura.

[in] BlockId

Numero che identifica il blocco da leggere. Viene definito 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 codice di errore NTSTATUS appropriato.

Commenti

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.

Requisiti