NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS struttura (ntddndis.h)

Articolo
02/29/2024

La struttura NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS specifica i parametri per cancellare un filtro di ricezione in una scheda di rete.

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

Unione dei pacchetti NDIS. Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Gestione dei filtri di ricezione del carbone dei pacchetti.
Virtualizzazione I/O radice singola (SR-IOV). Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Impostazione di un filtro di ricezione in una porta virtuale.
VMQ (Virtual Machine Queue). Per altre informazioni sull'uso dei filtri di ricezione in questa interfaccia, vedere Impostazione e cancellazione dei filtri VMQ.

Sintassi

typedef struct _NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_RECEIVE_QUEUE_ID  QueueId;
  NDIS_RECEIVE_FILTER_ID FilterId;
} NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS, *PNDIS_RECEIVE_FILTER_CLEAR_PARAMETERS;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS . Il driver imposta il membro Type della struttura che Header specifica su NDIS_OBJECT_TYPE_DEFAULT.

Per indicare la versione della struttura NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS , il driver imposta il membro Revision su uno dei valori seguenti:

NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS_REVISION_1

Versione originale per NDIS 6.20.

Il driver imposta il membro Size su NDIS_SIZEOF_RECEIVE_FILTER_CLEAR_PARAMETERS_REVISION_1.

Flags

Or bit per bit dei flag. Questo membro è riservato per NDIS.

QueueId

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

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

FilterId

Identificatore di filtro di ricezione. L'identificatore del filtro è un numero intero compreso tra uno e il numero di filtri di ricezione supportati dalla scheda di rete. Un valore pari a zero non è valido.

Commenti

La struttura NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS viene usata con richieste OID di
OID_RECEIVE_FILTER_CLEAR_FILTER per specificare un filtro da cancellare in una coda di ricezione VMQ o SR-IOV VPort. Il filtro è stato impostato in precedenza nella coda con OID_RECEIVE_FILTER_SET_FILTER OID.