struttura NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS (ntddndis.h)

Articolo
02/26/2024

La struttura NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS specifica i parametri per un'operazione di lettura 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 per una funzione fisica PCIe e PCIe.

Sintassi

typedef struct _NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS;

Members

Header

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

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

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_SRIOV_READ_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 di metodo OID di OID_NIC_SWITCH_ALLOCATE_VF.

BlockId

Valore ULONG che specifica l'identificatore del blocco di configurazione VF da leggere. 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 lettura.

BufferOffset

Valore ULONG che specifica l'offset, in unità di byte, dall'inizio di questa struttura a un buffer contenente i dati letti dal blocco di configurazione VF specificato.

Commenti

La struttura NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS viene utilizzata nelle richieste di metodi OID di OID_SRIOV_READ_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_READ_VF_CONFIG_BLOCK

Condividi tramite