NDIS_SRIOV_CAPABILITIES struttura (ntddndis.h)

Articolo
08/07/2023

La struttura NDIS_SRIOV_CAPABILITIES specifica le funzionalità di virtualizzazione I/O radice singola (SR-IOV) della scheda di rete.

Sintassi

typedef struct _NDIS_SRIOV_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              SriovCapabilities;
} NDIS_SRIOV_CAPABILITIES, *PNDIS_SRIOV_CAPABILITIES;

Members

Header

Tipo, revisione e dimensione della struttura NDIS_SRIOV_CAPABILITIES . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare il membro Type di Intestazione su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_SRIOV_CAPABILITIES , il driver deve impostare il membro Revisionedell'intestazione sul valore seguente:

NDIS_SRIOV_CAPABILITIES _REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_SRIOV_CAPABILITIES _REVISION_1.

Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS

SriovCapabilities

Valore ULONG che contiene un OR bit per bit dei flag seguenti:

NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

Specifica che la scheda di rete supporta la funzionalità SR-IOV.

Nota Questo flag deve essere impostato solo dal driver miniport per la funzione fisica PCI Express (PCIe) della scheda di rete. Questo driver viene eseguito nel sistema operativo di gestione. Questo sistema operativo viene eseguito nella partizione padre Hyper-V.

NDIS_SRIOV_CAPS_PF_MINIPORT

Specifica che si tratta di un driver miniport PF.

NDIS_SRIOV_CAPS_VF_MINIPORT

Specifica che si tratta di un driver miniport (VF) PCIe Virtual Function.

Commenti

Il driver miniport usa la struttura NDIS_SRIOV_CAPABILITIES per segnalare le funzionalità SR-IOV nei modi seguenti:

Il driver miniport chiama la funzione NdisMSetMiniportAttributes dalla funzione MiniportInitializeEx e imposta il parametro MiniportAttributes su un puntatore a una struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES . Il driver annuncia il supporto SR-IOV formattando i membri HardwareSriovCapabilities e CurrentSriovCapabilities come strutture NDIS_SRIOV_CAPABILITIES.
Quando il driver gestisce correttamente una richiesta di query OID di OID_SRIOV_HARDWARE_CAPABILITIES o OID_SRIOV_CURRENT_CAPABILITIES, restituisce una struttura NDIS_SRIOV_CAPABILITIES.

NDIS passa le funzionalità SR-IOV della scheda di rete ai driver che si associano alla scheda di rete nel modo seguente:

Quando NDIS chiama la funzione FilterAttach del driver di filtro overlying, NDIS passa le funzionalità SR-IOV della scheda di rete tramite il parametro AttachParameters . Questo parametro contiene un puntatore a una struttura NDIS_FILTER_ATTACH_PARAMETERS . Il membro SriovCapabilities di questa struttura contiene un puntatore a una struttura NDIS_SRIOV_CAPABILITIES .
Quando NDIS chiama una funzione ProtocolBindAdapterEx di protocollo overlying, NDIS passa le funzionalità SR-IOV della scheda di rete tramite il parametro BindParameters . Questo parametro contiene un puntatore a una struttura NDIS_FILTER_ATTACH_PARAMETERS . Il membro SriovCapabilities di questa struttura contiene un puntatore a una struttura NDIS_SRIOV_CAPABILITIES .