struttura NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS (ntddndis.h)

Articolo
03/05/2024

La struttura NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS specifica i parametri per un'operazione di scrittura nel blocco di configurazione della funzione virtuale PCI Express (PCIe) di una scheda di rete. Questi parametri vengono usati per la comunicazione backchannel tra i driver miniport VF e PCIe Physical Function (PF).

Sintassi

typedef struct _NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver deve impostare il membro Type di Header su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS , il driver deve impostare il membro Revision di Header sul valore seguente:

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1.

VFId

Valore NDIS_SRIOV_FUNCTION_ID che specifica l'identificatore univoco del VF nella scheda di rete.

Nota Il valore VF con il valore NDIS_SRIOV_FUNCTION_ID specificato deve avere risorse allocate in precedenza tramite una richiesta del metodo OID (Object Identifier) di OID_NIC_SWITCH_ALLOCATE_VF.

BlockId

Valore ULONG che specifica l'identificatore del blocco di configurazione VF in cui scrivere. Questo identificatore è proprietario del fornitore hardware indipendente (IHV) e viene usato solo dai driver miniport per pf e VF nella scheda di rete.

Per altre informazioni, vedere la sezione Osservazioni.

Length

Valore ULONG che specifica la lunghezza, in unità di byte, dell'operazione di scrittura.

BufferOffset

Valore ULONG che specifica l'offset, in unità di byte, dall'inizio di questa struttura a un buffer che contiene i dati da scrivere nel blocco di configurazione VF specificato.

Commenti

La struttura NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS viene usata in una richiesta di set OID di OID_SRIOV_WRITE_VF_CONFIG_BLOCK.

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. I dati di un blocco di configurazione VF possono essere scambiati tra i driver seguenti:

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

Nota L'utilizzo del blocco di configurazione VF e il formato dei relativi dati di configurazione sono definiti dal fornitore hardware indipendente (IHV) del dispositivo. I dati di configurazione vengono usati solo dai driver PF e miniport VF.

Per altre informazioni sulla comunicazione backchannel all'interno dell'interfaccia SR-IOV (Single Root I/O Virtualization), vedere SR-IOV PF/VF Backchannel Communication.For more information about backchannel communication within the single root I/O virtualization interface (SR-IOV), see SR-IOV PF/VF Backchannel Communication.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.30 e versioni successive.
Intestazione	ntddndis.h (include Ndis.h)

Vedi anche

NDIS_OBJECT_HEADER

OID_SRIOV_WRITE_VF_CONFIG_BLOCK

Condividi tramite