OID_GEN_CURRENT_PACKET_FILTER
En tant que requête, l’OID OID_GEN_CURRENT_PACKET_FILTER signale les types de paquets nets qui figurent dans les indications de réception d’un pilote miniport.
En tant qu’ensemble, l’OID OID_GEN_CURRENT_PACKET_FILTER spécifie les types de paquets nets pour lesquels un protocole reçoit des indications d’un pilote miniport.
Informations sur la version
Windows Vista et versions ultérieures de Windows
Pris en charge.
Pilotes miniport NDIS 6.0 et ultérieur
Mandatory. (voir la section Remarques)
Pilotes miniport NDIS 5.1
Mandatory.
Pilotes miniport NDIS 5.1
Mandatory.
Notes
Pour les pilotes miniport NDIS 6.0 et ultérieur, la requête n’est pas demandée et l’ensemble est obligatoire. NDIS gère la requête pour les pilotes miniport. Le pilote miniport signale les informations de filtre de paquets lors de l’initialisation.
Le pilote miniport signale son type moyen comme un pour lequel le système fournit une bibliothèque de filtres. Le filtre de paquets utilise l’opération OR pour combiner de manière inclusive les types suivants :
NDIS_PACKET_TYPE_DIRECTED
Paquets dirigés. Les paquets dirigés contiennent une adresse de destination égale à l’adresse de la station de la carte réseau.
NDIS_PACKET_TYPE_MULTICAST
Paquets d’adresses de multidiffusion envoyés aux adresses dans la liste d’adresses de multidiffusion.
Un pilote de protocole peut recevoir des paquets de multidiffusion Ethernet (802.3) en spécifiant le type de paquet de multidiffusion ou d’adresse fonctionnelle. La définition de la liste d’adresses de multidiffusion ou de l’adresse fonctionnelle détermine les groupes d’adresses de multidiffusion activés par le pilote de carte réseau.
NDIS_PACKET_TYPE_ALL_MULTICAST
Tous les paquets d’adresses de multidiffusion, pas seulement ceux énumérés dans la liste d’adresses de multidiffusion.
NDIS_PACKET_TYPE_BROADCAST
Paquets de diffusion.
NDIS_PACKET_TYPE_PROMISCUOUS
Spécifie tous les paquets, que le filtrage du réseau local virtuel soit activé ou non et que l’identificateur de réseau local virtuel corresponde ou non.
NDIS_PACKET_TYPE_ALL_FUNCTIONAL
Tous les paquets d’adresses fonctionnelles, pas seulement ceux de l’adresse fonctionnelle actuelle.
NDIS_PACKET_TYPE_ALL_LOCAL
Tous les paquets envoyés par les protocoles installés et tous les paquets indiqués par la carte réseau identifiée par un NdisBindingHandle donné .
NDIS_PACKET_TYPE_FUNCTIONAL
Paquets d’adresses fonctionnelles envoyés aux adresses incluses dans l’adresse fonctionnelle actuelle.
NDIS_PACKET_TYPE_GROUP
Paquets envoyés à l’adresse du groupe actuel.
NDIS_PACKET_TYPE_MAC_FRAME
Trames de pilote de carte réseau qu’une carte réseau d’anneau de jeton reçoit.
NDIS_PACKET_TYPE_SMT
Paquets SMT qu’une carte réseau FDDI reçoit.
NDIS_PACKET_TYPE_SOURCE_ROUTING
Tous les paquets de routage source. Si le pilote de protocole définit ce bit, la bibliothèque NDIS tente d’agir en tant que pont de routage source.
Pour les adaptateurs miniport dont le type de média est NdisMedium802_3 ou NdisMedium802_5, NDIS désactive la réception des paquets, ainsi que la multidiffusion et les adresses fonctionnelles lors d’un appel à la fonction NdisOpenAdapterEx .
Pour les adaptateurs miniport avec tous les autres types de supports, le pilote de protocole peut commencer à recevoir des paquets à tout moment pendant l’appel NdisOpenAdapterEx . Notez que le protocole peut même recevoir des paquets avant le retour de NdisOpenAdapterEx . En général, le filtrage des paquets est le meilleur effort, et les pilotes de protocole doivent être prêts à gérer les indications de réception même lorsque le filtre de paquets est égal à zéro.
Pour une requête, NDIS retourne les filtres de liaison qui sont combinés à l’aide de l’opérateur OR.
Pour un ensemble, le filtre de paquets spécifié remplace le filtre de paquets précédent pour la liaison. Si le pilote miniport a précédemment activé un type de paquet, mais que le pilote de protocole ne spécifie pas ce type dans un nouveau filtre, le pilote de protocole ne reçoit pas de paquets de ce type.
Pour les adaptateurs miniport dont le type de média est NdisMedium802_3 ou NdisMedium802_5, si le pilote miniport ne définit pas un bit pour un type de paquet particulier en réponse à cette requête, le pilote de protocole ne reçoit pas de paquets de ce type. Par conséquent, un pilote de protocole peut désactiver la réception de paquets en appelant la fonction NdisOidRequest ou NdisCoOidRequest à l’aide d’un filtre de zéro.
Pour les adaptateurs miniport avec tous les autres types de supports, NDIS ne case activée pas le type de paquet. Pour ces types de supports, un pilote de protocole ne peut pas désactiver la réception des paquets en spécifiant un filtre de zéro.
Quand la fonction MiniportInitializeEx d’un pilote miniport est appelée, le filtre de paquets du pilote miniport doit être défini sur zéro. Lorsque le filtre de paquets est égal à zéro, les indications de réception sont désactivées. Une fois que la fonction MiniportInitializeEx d’un pilote miniport a été retournée, un pilote de protocole peut définir OID_GEN_CURRENT_PACKET_FILTER sur une valeur différente de zéro, ce qui permet au pilote miniport d’indiquer les paquets reçus à ce protocole.
Si le mode promiscuous est activé avec le bit NDIS_PACKET_TYPE_PROMISCUOUS, le pilote de protocole continue de recevoir des paquets même si le nœud réseau d’envoi ne les y dirige pas. NDIS envoie ensuite le pilote de protocole tous les paquets reçus par la carte réseau.
La définition d’un filtre de paquets spécifique ne modifie pas le filtre de paquets pour d’autres pilotes de protocole qui sont liés (ou plus) à la même carte réseau. Par exemple, si un protocole lié active le mode promiscuous, les autres pilotes de protocole lié ne reçoivent pas de paquets qu’ils n’ont pas spécifiquement demandés avec leurs propres filtres de paquets.
Filtres de paquets 802.11 natifs
Le pilote miniport Native 802.11 doit uniquement prendre en charge les types de filtres de paquets standard suivants :
NDIS_PACKET_TYPE_DIRECTED
NDIS_PACKET_TYPE_MULTICAST
NDIS_PACKET_TYPE_BROADCAST
NDIS_PACKET_TYPE_PROMISCUOUS
Lorsqu’ils sont activés, ces filtres de paquets standard s’appliquent uniquement aux paquets de données 802.11.
En outre, le pilote miniport Native 802.11 doit prendre en charge les types de filtres de paquets suivants, qui sont spécifiques au média Native 802.11 :
NDIS_PACKET_TYPE_802_11_RAW_DATA
Frame MPDU (Media Access Control) 802.11, qui contient toutes les données au format reçu par la station 802.11. Lorsque ce filtre est défini, le pilote doit indiquer chaque fragment MPDU non modifié avant d’indiquer le paquet MSDU (Service Data Unit) MAC réassemblage à partir des fragments MPDU.
Si un fragment MPDU est chiffré, il ne doit pas déchiffrer le fragment avant d’être indiqué. Toutefois, le pilote miniport doit déchiffrer chaque fragment MPDU avant de réassembler et d’indiquer le paquet MSDU.
S’il est activé, ce type de filtre affecte uniquement d’autres filtres de paquets standard, tels que NDIS_PACKET_TYPE_DIRECTED ou NDIS_PACKET_TYPE_BROADCAST.
Pour plus d’informations sur la méthode permettant d’indiquer des paquets de données 802.11 bruts, consultez Indication des paquets bruts 802.11.
NDIS_PACKET_TYPE_802_11_DIRECTED_MGMT
A dirigé les paquets de gestion 802.11. Les paquets dirigés contiennent une adresse de destination égale à l’adresse de la station de la carte réseau.
NDIS_PACKET_TYPE_802_11_MULTICAST_MGMT
Paquets de gestion de multidiffusion 802.11 envoyés aux adresses de la liste d’adresses de multidiffusion.
NDIS_PACKET_TYPE_802_11_ALL_MULTICAST_MGMT
Tous les paquets de gestion de multidiffusion 802.11 reçus par la station 802.11, que l’adresse de destination dans l’en-tête MAC 802.11 figure ou non dans la liste d’adresses de multidiffusion.
NDIS_PACKET_TYPE_802_11_BROADCAST_MGMT
Diffuser les paquets de gestion 802.11 reçus par la station 802.11.
NDIS_PACKET_TYPE_802_11_PROMISCUOUS_MGMT
Tous les paquets de gestion 802.11 reçus par la station 802.11.
NDIS_PACKET_TYPE_802_11_RAW_MGMT
Frame de gestion MPDU 802.11, qui contient toutes les données au format reçu par la station 802.11. Lorsque ce filtre est défini, le pilote doit indiquer chaque fragment MPDU non modifié avant d’indiquer le paquet MMPDU (Management Protocol Data Unit) MAC réassemblage à partir des fragments MPDU.
S’il est activé, ce type de filtre affecte uniquement les autres filtres de paquets de gestion 802.11, tels que NDIS_PACKET_TYPE_802_11_DIRECTED_MGMT ou NDIS_PACKET_TYPE_802_11_MULTICAST_MGMT.
Pour plus d’informations sur la méthode permettant d’indiquer les paquets de gestion 802.11 bruts, consultez Indication des paquets bruts 802.11.
NDIS_PACKET_TYPE_802_11_DIRECTED_CTRL
Dirigé les paquets de contrôle 802.11. Les paquets dirigés contiennent une adresse de destination égale à l’adresse de station de la carte réseau.
NDIS_PACKET_TYPE_802_11_BROADCAST_CTRL
Diffuser les paquets de contrôle 802.11 reçus par la station 802.11.
NDIS_PACKET_TYPE_802_11_PROMISCUOUS_CTRL
Tous les paquets de contrôle 802.11 reçus par la station 802.11.
Si un pilote miniport fonctionne en mode NetMon (Network Monitor) natif 802.11 ou point d’accès extensible (AP), le pilote doit activer les filtres de paquets suivants via une demande définie de 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 pilote miniport fonctionnant dans d’autres modes natifs 802.11 en plus de NetMon ne doit pas activer ces paramètres de filtre de paquets, à l’exception de NDIS_PACKET_TYPE_802_11_PROMISCUOUS_CTRL. Un pilote miniport qui ne fonctionne pas en mode NetMon peut éventuellement activer NDIS_PACKET_TYPE_802_11_PROMISCUOUS_CTRL via une requête définie de OID_GEN_CURRENT_PACKET_FILTER.
Note Lorsque le pilote miniport est en mode Natif 802.11 autre que NetMon, et que OID_GEN_CURRENT_PACKET_FILTER est défini, le pilote ne doit pas échouer à la demande de jeu si des paramètres de filtres promiscuieux ou bruts sont activés dans les données OID.
Pour plus d’informations sur les modes de fonctionnement NetMon et ExtAP, consultez les rubriques suivantes :
Mode d’opération du moniteur réseau
Mode de fonctionnement du point d’accès extensible
Spécifications
En-tête |
Ntddndis.h (inclure Ndis.h) |