struttura NDIS_SRIOV_CAPABILITIES (ntddndis.h)

Articolo
02/07/2025

La struttura NDIS_SRIOV_CAPABILITIES specifica le singole funzionalità di virtualizzazione di I/O radice (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;

Membri

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 Header su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura di NDIS_SRIOV_CAPABILITIES, il driver deve impostare il membro revisione di Header sul valore seguente:

NDIS_SRIOV_CAPABILITIES _REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro dimensioni 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 SR-IOV funzionalità.

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 Hyper-V partizione padre.

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 PCIe Virtual Function (VF).

Osservazioni

Il driver miniport usa la struttura NDIS_SRIOV_CAPABILITIES per segnalare le relative funzionalità di 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 SR-IOV supporto formattando i HardwareSriovCapabilities e CurrentSriovCapabilities membri come strutture di 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à di SR-IOV della scheda di rete ai driver overlying associati alla scheda di rete nel modo seguente:

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