OID_802_3_ADD_MULTICAST_ADDRESS
En tant que requête définie, NDIS et les pilotes de protocole overlying utilisent la requête OID OID_802_3_ADD_MULTICAST_ADDRESS pour ajouter une adresse de multidiffusion 802.3 à la liste d’adresses de multidiffusion d’un adaptateur miniport. L’adresse de multidiffusion est un tableau de 6 octets. L’ajout d’une adresse permet à cette adresse de recevoir des paquets de multidiffusion.
Informations sur la version
Pilotes miniport NDIS 6.0 et versions ultérieures
Non demandé.
Notes
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient l’adresse de 6 octets à ajouter à la liste d’adresses de multidiffusion.
La requête OID OID_802_3_ADD_MULTICAST_ADDRESS ne peut ajouter qu’une seule adresse. Pour ajouter plusieurs adresses, le pilote qui se superpose doit émettre plusieurs requêtes OID OID_802_3_ADD_MULTICAST_ADDRESS.
Les pilotes miniportS NDIS ne reçoivent pas directement cette requête OID. Au lieu de cela, NDIS regroupe chaque séquence de OID_802_3_ADD_MULTICAST_ADDRESS et OID_802_3_DELETE_MULTICAST_ADDRESS requêtes OID en une seule requête OID OID_802_3_MULTICAST_LIST , qu’il envoie au pilote miniport.
Pour recevoir des paquets de multidiffusion, le pilote overlying doit utiliser le OID_GEN_CURRENT_PACKET_FILTER OID pour définir le filtre de paquets NDIS_PACKET_TYPE_MULTICAST indicateur.
Le pilote miniport peut définir une limite sur le nombre d’adresses de multidiffusion que la liste d’adresses de multidiffusion peut contenir. Pour spécifier le nombre maximal d’adresses de multidiffusion, le pilote miniport définit le membre MaxMulticastListSize de la structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES qu’il transmet à la fonction NdisMSetMiniportAttributes . Pour les pilotes miniports basés sur les versions NDIS antérieures à NDIS 6.0, NDIS interroge le nombre maximal d’adresses de multidiffusion en envoyant une requête OID OID_802_3_MAXIMUM_LIST_SIZE . NDIS retourne NDIS_STATUS_MULTICAST_FULL si une requête OID_802_3_ADD_MULTICAST_ADDRESS dépasse cette limite.
Pour supprimer une adresse de multidiffusion précédemment ajoutée, effectuez une demande d’ensemble avec le OID_802_3_DELETE_MULTICAST_ADDRESS OID. Le pilote qui se superpose peut ajouter une adresse de multidiffusion donnée plusieurs fois. Si NDIS réussit la première demande d’ajout pour une adresse de multidiffusion donnée, NDIS réussit toutes les demandes d’ajout suivantes pour cette adresse. Pour supprimer une adresse de multidiffusion qui a été ajoutée plusieurs fois, le pilote en sur-position doit supprimer l’adresse le même nombre de fois qu’il a ajouté l’adresse.
Spécifications
En-tête |
Ntddndis.h (inclure Ndis.h) |
Voir aussi
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES