struttura NDIS_RECEIVE_FILTER_INFO_ARRAY (ntddndis.h)

Articolo
02/26/2024

La struttura NDIS_RECEIVE_FILTER_INFO_ARRAY specifica un elenco di filtri di ricezione attualmente configurati in un driver miniport.

I filtri di ricezione NDIS vengono usati nelle interfacce NDIS seguenti:

Unione di pacchetti NDIS. Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Managing Packet Coalescing Receive Filters.For more information about how to use receive filters in this interface, see Managing Packet Coalescing Receive Filters.
Single Root I/O Virtualization (SR-IOV). Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Impostazione di un filtro di ricezione su una porta virtuale.
VMQ (Virtual Machine Queue). Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Impostazione e cancellazione dei filtri VMQ.

Sintassi

typedef struct _NDIS_RECEIVE_FILTER_INFO_ARRAY {
  NDIS_OBJECT_HEADER       Header;
  NDIS_RECEIVE_QUEUE_ID    QueueId;
  ULONG                    FirstElementOffset;
  ULONG                    NumElements;
  ULONG                    ElementSize;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NDIS_RECEIVE_FILTER_INFO_ARRAY, *PNDIS_RECEIVE_FILTER_INFO_ARRAY;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_RECEIVE_FILTER_INFO_ARRAY . 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_RECEIVE_FILTER_INFO_ARRAY , il driver deve impostare il membro Revision di Header sul valore seguente:

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2

Aggiunti membri per NDIS 6.30.

Impostare il membro Size su NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2.

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1

Versione originale per NDIS 6.20.

Impostare il membro Size su NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1.

QueueId

Identificatore della coda di ricezione. Questo identificatore è un numero intero compreso tra zero e il numero di code supportate dalla scheda di rete. Il valore NDIS_DEFAULT_RECEIVE_QUEUE_ID specifica la coda di ricezione predefinita.

Nota I driver Miniport che supportano l'unione di pacchetti NDIS o l'interfaccia SR-IOV devono impostare il membro QueueId su NDIS_DEFAULT_RECEIVE_QUEUE_ID.

FirstElementOffset

Offset, in byte, al primo elemento di una matrice di elementi che seguono questa struttura. L'offset viene misurato dall'inizio della struttura NDIS_RECEIVE_FILTER_INFO_ARRAY fino all'inizio del primo elemento. Ogni elemento nella matrice è una struttura NDIS_RECEIVE_FILTER_INFO .

Nota Se NumElements è impostato su zero, questo membro viene ignorato.

NumElements

Numero di elementi nella matrice.

ElementSize

Dimensione in byte di ogni elemento nella matrice.

Flags

OR bit per bit dei flag seguenti:

NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED

Se questo flag è impostato, vengono richieste informazioni sui filtri di ricezione configurati sulla porta virtuale (VPort) specificata dal membro VPortId .

Nota Questo flag è valido solo per l'interfaccia SR-IOV.

VPortId

Identificatore della porta virtuale (VPort) su cui vengono sottoposti query i filtri di ricezione. L'identificatore VPort deve essere uno dei valori seguenti:

Identificatore di un VPort allocato in precedenza tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_VPORT.
Valore di NDIS_DEFAULT_VPORT_ID che specifica il VPort predefinito nell'opzione della scheda di interfaccia di rete.

Un commutatore di interfaccia di rete è supportato dalle schede di rete per l'interfaccia SR-IOV. L'opzione della scheda di interfaccia di rete può essere configurata per avere uno o più VPort.

Nota Il membro VPortId è valido solo se il flag NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED è impostato in Flags.

Commenti

La struttura NDIS_RECEIVE_FILTER_INFO_ARRAY viene usata nella richiesta OID di OID_RECEIVE_FILTER_ENUM_FILTERS. Questa richiesta OID enumera i filtri di ricezione in una coda di ricezione VMQ o SR-IOV. Ogni elemento nella matrice che segue la struttura NDIS_RECEIVE_FILTER_INFO_ARRAY è un NDIS_RECEIVE_FILTER_INFO struttura.