VPCI_WRITE_BLOCK funzione di callback (vpci.h)

La routine WriteVfConfigBlock scrive un blocco di dati di configurazione per una funzione virtuale PCI Express (VF). Questa routine viene chiamata dal driver di un PCIe VF in un dispositivo che supporta l'interfaccia di virtualizzazione I/O radice singola (SR-IOV).

Sintassi

VPCI_WRITE_BLOCK VpciWriteBlock;

NTSTATUS VpciWriteBlock(
  PVOID Context,
  ULONG BlockId,
  PVOID Buffer,
  ULONG Length
)
{...}

Parametri

Context

[in] Puntatore a informazioni di contesto specifiche dell'interfaccia. Il chiamante passa il valore passato come membro Context della struttura VPCI_INTERFACE_STANDARD per l'interfaccia.

BlockId

[in] Identificatore del blocco di configurazione VF da scrivere. Questo identificatore è proprietario del fornitore hardware indipendente (IHV) e viene usato solo dai driver per la funzione fisica PCIe (PF) e VF nel dispositivo.

Buffer

[in] Puntatore a un buffer allocato dal chiamante che contiene i dati di configurazione da scrivere. Per altre informazioni, vedere la sezione Osservazioni.

Length

[in] Numero di byte da scrivere nel blocco di configurazione VF.

Valore restituito

La routine ReadVfConfigBlock restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, la routine restituisce un valore NTSTATUS appropriato.

Commenti

Quando viene chiamata la routine WriteVfConfigBlock , il driver del pf riceve una notifica per aggiornare un blocco di configurazione VF specificato con i dati specificati.

Un blocco di configurazione VF viene usato per la comunicazione backchannel tra i driver del file PF PCIe e un VF in un dispositivo che supporta l'interfaccia SR-IOV. L'IHV può definire uno o più blocchi di configurazione VF per il dispositivo. Ogni blocco di configurazione VF ha un formato, una lunghezza e un ID blocco definiti dall'IHV.

I dati di configurazione VF possono essere scambiati tra i driver seguenti in modo protetto:

• Driver VF, che viene eseguito nel sistema operativo guest. Questo sistema operativo viene eseguito all'interno di una partizione figlio Hyper-V.
• Driver PF, che viene eseguito nel sistema operativo di gestione. Questo sistema operativo viene eseguito all'interno della partizione padre hyper-V.

I dati di ogni blocco di configurazione VF vengono usati solo dai driver di PF e VF.

Requisiti

Vedi anche

IOCTL_VPCI_WRITE_BLOCK

VPCI_INTERFACE_STANDARD