OID_GEN_CURRENT_PACKET_FILTER

Articolo
06/15/2023

Come query, l'OID OID_GEN_CURRENT_PACKET_FILTER segnala i tipi di pacchetti net che si trovano in ricezione di indicazioni da un driver miniport.

Come set, l'OID OID_GEN_CURRENT_PACKET_FILTER specifica i tipi di pacchetti net per cui un protocollo riceve indicazioni da un driver miniport.

Informazioni sulla versione

Windows Vista e versioni successive di Windows
Supportata.

Driver miniport NDIS 6.0 e versioni successive
Mandatory. (vedere la sezione Osservazioni)

Driver miniport NDIS 5.1
Mandatory.

Windows XP
Supportata.

Driver miniport NDIS 5.1
Mandatory.

Commenti

Per i driver miniport NDIS 6.0 e versioni successive, la query non è richiesta e il set è obbligatorio. NDIS gestisce la query per i driver miniport. Il driver miniport segnala le informazioni sul filtro dei pacchetti durante l'inizializzazione.

Il driver miniport segnala il relativo tipo medio come uno per il quale il sistema fornisce una libreria di filtri. Il filtro dei pacchetti usa l'operazione OR per combinare in modo inclusivo i tipi seguenti:

NDIS_PACKET_TYPE_DIRECTED
Pacchetti indirizzati. I pacchetti indirizzati contengono un indirizzo di destinazione uguale all'indirizzo della scheda di interfaccia di rete.

NDIS_PACKET_TYPE_MULTICAST
Pacchetti di indirizzi multicast inviati agli indirizzi nell'elenco indirizzi multicast.

Un driver di protocollo può ricevere pacchetti multicast Ethernet (802.3) specificando il tipo di pacchetto di indirizzi multicast o funzionale. L'impostazione dell'elenco di indirizzi multicast o dell'indirizzo funzionale determina i gruppi di indirizzi multicast abilitati dal driver della scheda di interfaccia di rete.

NDIS_PACKET_TYPE_ALL_MULTICAST
Tutti i pacchetti di indirizzi multicast, non solo quelli enumerati nell'elenco indirizzi multicast.

NDIS_PACKET_TYPE_BROADCAST
Trasmettere pacchetti.

NDIS_PACKET_TYPE_PROMISCUOUS
Specifica tutti i pacchetti indipendentemente dal fatto che il filtro VLAN sia abilitato o meno e che l'identificatore VLAN corrisponda o meno.

NDIS_PACKET_TYPE_ALL_FUNCTIONAL
Tutti i pacchetti di indirizzi funzionali, non solo quelli nell'indirizzo funzionale corrente.

NDIS_PACKET_TYPE_ALL_LOCAL
Tutti i pacchetti inviati da protocolli installati e tutti i pacchetti indicati dalla scheda di interfaccia di rete identificata da un determinato NdisBindingHandle .

NDIS_PACKET_TYPE_FUNCTIONAL
Pacchetti di indirizzi funzionali inviati agli indirizzi inclusi nell'indirizzo funzionale corrente.

NDIS_PACKET_TYPE_GROUP
Pacchetti inviati all'indirizzo del gruppo corrente.

NDIS_PACKET_TYPE_MAC_FRAME
Fotogrammi del driver di interfaccia di rete ricevuti da una scheda di interfaccia di interfaccia di rete che riceve un anello token.

NDIS_PACKET_TYPE_SMT
Pacchetti SMT ricevuti da una scheda di interfaccia di rete FDDI.

NDIS_PACKET_TYPE_SOURCE_ROUTING
Tutti i pacchetti di routing di origine. Se il driver del protocollo imposta questo bit, la libreria NDIS tenta di agire come bridge di routing di origine.

Per le schede miniport il cui tipo di supporto è NdisMedium802_3 oNdisMedium802_5, NDIS disabilita la ricezione dei pacchetti, insieme agli indirizzi multicast e funzionali durante una chiamata alla funzione NdisOpenAdapterEx.

Per le schede miniport con tutti gli altri tipi di supporti, il driver del protocollo può iniziare a ricevere pacchetti in qualsiasi momento durante la chiamata NdisOpenAdapterEx . Si noti che il protocollo può anche ricevere pacchetti prima che NdisOpenAdapterEx restituisca. In generale, il filtro dei pacchetti è il miglior sforzo e i driver di protocollo devono essere preparati per gestire le indicazioni di ricezione anche quando il filtro del pacchetto è zero.

Per una query, NDIS restituisce i filtri di associazione combinati usando l'operatore OR.

Per un set, il filtro del pacchetto specificato sostituisce il filtro del pacchetto precedente per l'associazione. Se il driver miniport abilitato in precedenza un tipo di pacchetto, ma il driver del protocollo non specifica tale tipo in un nuovo filtro, il driver del protocollo non riceverà pacchetti di questo tipo.

Per le schede miniport il cui tipo di supporto è NdisMedium802_3 oNdisMedium802_5, se il driver miniport non imposta un bit per un tipo di pacchetto specifico in risposta a questa query, il driver del protocollo non riceverà pacchetti di tale tipo. Di conseguenza, un driver di protocollo può disabilitare la ricezione dei pacchetti chiamando la funzione NdisOidRequest o NdisCoOidRequest usando un filtro pari a zero.

Per le schede miniport con tutti gli altri tipi di supporti, NDIS non controlla il tipo di pacchetto. Per questi tipi di supporti, un driver di protocollo non può disabilitare la ricezione dei pacchetti specificando un filtro pari a zero.

Quando viene chiamata la funzione MiniportInitializeEx di un driver miniport, il filtro del pacchetto del driver miniport deve essere impostato su zero. Quando il filtro del pacchetto è zero, le indicazioni di ricezione sono disabilitate. Dopo aver restituito una funzione MiniportInitializeEx di un driver di protocollo, un driver del protocollo può impostare OID_GEN_CURRENT_PACKET_FILTER su un valore diverso da zero, consentendo così al driver miniport di indicare i pacchetti ricevuti a tale protocollo.

Se la modalità promiscua è abilitata con il bit NDIS_PACKET_TYPE_PROMISCUOUS, il driver del protocollo continua a ricevere pacchetti anche se il nodo di rete di invio non li indirizza a esso. NDIS invia quindi il driver del protocollo a tutti i pacchetti ricevuti dalla scheda di interfaccia di rete.

L'impostazione di un filtro di pacchetto specifico non modifica il filtro dei pacchetti per altri driver di protocollo associati alla stessa scheda di interfaccia di rete (o superiore). Ad esempio, se un protocollo associato abilita la modalità promiscua, altri driver di protocollo associati non ricevono pacchetti che non hanno richiesto in modo specifico con i propri filtri di pacchetto.

Filtri pacchetti nativi 802.11

Il driver miniport nativo 802.11 deve supportare solo i tipi di filtro dei pacchetti standard seguenti:

NDIS_PACKET_TYPE_DIRECTED
NDIS_PACKET_TYPE_MULTICAST
NDIS_PACKET_TYPE_BROADCAST
NDIS_PACKET_TYPE_PROMISCUOUS

Se abilitato, questi filtri di pacchetti standard sono applicabili solo ai pacchetti di dati 802.11.

Inoltre, il driver miniport nativo 802.11 deve supportare i tipi di filtro pacchetti seguenti, specifici per il supporto Nativo 802.11:

NDIS_PACKET_TYPE_802_11_RAW_DATA
Frame 802.11 media access control (MAC) protocol data unit (MPDU), che contiene tutti i dati nel formato ricevuto dalla stazione 802.11. Quando questo filtro è impostato, il driver deve indicare ogni frammento MPDU non modificato prima di indicare il pacchetto MAC service data unit (MSDU) riassemblato dai frammenti MPDU.

Se un frammento MPDU è crittografato, non deve decrittografare il frammento prima di essere indicato. Tuttavia, il driver miniport deve decrittografare ogni frammento MPDU prima di riassemblare e indicare il pacchetto MSDU.

Se abilitato, questo tipo di filtro influisce solo su altri filtri di pacchetti standard, ad esempio NDIS_PACKET_TYPE_DIRECTED o NDIS_PACKET_TYPE_BROADCAST.

Per altre informazioni sul metodo per indicare pacchetti di dati non elaborati 802.11, vedere Indicare pacchetti non elaborati 802.11.

NDIS_PACKET_TYPE_802_11_DIRECTED_MGMT
Pacchetti di gestione diretti 802.11. I pacchetti indirizzati contengono un indirizzo di destinazione uguale all'indirizzo della scheda di interfaccia di rete.

NDIS_PACKET_TYPE_802_11_MULTICAST_MGMT
Pacchetti di gestione multicast 802.11 inviati agli indirizzi nell'elenco indirizzi multicast.

NDIS_PACKET_TYPE_802_11_ALL_MULTICAST_MGMT
Tutti i pacchetti di gestione multicast 802.11 ricevuti dalla stazione 802.11, indipendentemente dal fatto che l'indirizzo di destinazione nell'intestazione MAC 802.11 si trova nell'elenco indirizzi multicast.

NDIS_PACKET_TYPE_802_11_BROADCAST_MGMT
Trasmettere pacchetti di gestione 802.11 ricevuti dalla stazione 802.11.

NDIS_PACKET_TYPE_802_11_PROMISCUOUS_MGMT
Tutti i pacchetti di gestione 802.11 ricevuti dalla stazione 802.11.

NDIS_PACKET_TYPE_802_11_RAW_MGMT
Frame di gestione MPDU 802.11 che contiene tutti i dati nel formato ricevuto dalla stazione 802.11. Quando questo filtro è impostato, il driver deve indicare ogni frammento MPDU non modificato prima di indicare il pacchetto MMPDU (MAC Management Protocol Data Unit) riassemblato dai frammenti MPDU.

Se abilitato, questo tipo di filtro influisce solo su altri filtri pacchetti di gestione 802.11, ad esempio NDIS_PACKET_TYPE_802_11_DIRECTED_MGMT o NDIS_PACKET_TYPE_802_11_MULTICAST_MGMT.

Per altre informazioni sul metodo per indicare pacchetti di gestione non elaborati 802.11, vedere Indica pacchetti non elaborati 802.11.

NDIS_PACKET_TYPE_802_11_DIRECTED_CTRL
Pacchetti di controllo diretti 802.11. I pacchetti diretti contengono un indirizzo di destinazione uguale all'indirizzo stazione della scheda di interfaccia di rete.

NDIS_PACKET_TYPE_802_11_BROADCAST_CTRL
Trasmettere pacchetti di controllo 802.11 ricevuti dalla stazione 802.11.

NDIS_PACKET_TYPE_802_11_PROMISCUOUS_CTRL
Tutti i pacchetti di controllo 802.11 ricevuti dalla stazione 802.11.

Se un driver miniport funziona in modalità Native 802.11 Network Monitor (NetMon) o Extensible Access Point (AP), il driver deve abilitare i filtri di pacchetto seguenti tramite una richiesta set di OID_GEN_CURRENT_PACKET_FILTER.

NDIS_PACKET_TYPE_PROMISCUOUS
NDIS_PACKET_TYPE_802_11_RAW_DATA
NDIS_PACKET_TYPE_802_11_PROMISCUOUS_MGMT
NDIS_PACKET_TYPE_802_11_RAW_MGMT
NDIS_PACKET_TYPE_802_11_PROMISCUOUS_CTRL

Un driver miniport che opera in altre modalità Native 802.11 oltre a NetMon non deve abilitare queste impostazioni di filtro pacchetti, ad eccezione di NDIS_PACKET_TYPE_802_11_PROMISCUOUS_CTRL. Un driver miniport che non funziona in modalità NetMon può facoltativamente abilitare NDIS_PACKET_TYPE_802_11_PROMISCUOUS_CTRL tramite una richiesta set di OID_GEN_CURRENT_PACKET_FILTER.

Nota Quando il driver miniport si trova in modalità Native 802.11 diverse da NetMon e OID_GEN_CURRENT_PACKET_FILTER è impostato, il driver non deve interrompere la richiesta set se nei dati OID sono abilitate impostazioni di filtro promiscue o non elaborate.

Per altre informazioni sulle modalità operative NetMon e ExtAP, vedere gli argomenti seguenti:

Modalità operativa di Monitoraggio di rete

Modalità operativa del punto di accesso estendibile