OID_802_3_DELETE_MULTICAST_ADDRESS
En tant que requête définie, NDIS et les pilotes de protocole overlying utilisent l’OID OID_802_3_DELETE_MULTICAST_ADDRESS pour supprimer une adresse de multidiffusion précédemment ajoutée de la liste d’adresses de multidiffusion d’un adaptateur miniport. L’adresse de multidiffusion est un tableau de 6 octets. La suppression d’une adresse désactive cette adresse afin qu’elle ne puisse plus recevoir de paquets de multidiffusion.
Informations sur la version
Pilotes miniport NDIS 6.0 et ultérieur
Non demandé.
Notes
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient l’adresse de 6 octets à supprimer de la liste d’adresses de multidiffusion.
La requête OID OID_802_3_DELETE_MULTICAST_ADDRESS ne peut supprimer qu’une seule adresse. Pour supprimer plusieurs adresses, le pilote de protocole doit émettre plusieurs requêtes OID OID_802_3_DELETE_MULTICAST_ADDRESS.
Les pilotes miniport NDIS ne reçoivent pas directement cette demande OID. Au lieu de cela, NDIS consolide chaque séquence de requêtes OID_802_3_ADD_MULTICAST_ADDRESS et OID_802_3_DELETE_MULTICAST_ADDRESS OID en une seule requête OID OID_802_3_MULTICAST_LIST .
Pour remplacer ou supprimer l’intégralité de la liste de multidiffusion, le pilote de protocole peut utiliser la requête OID OID_802_3_MULTICAST_LIST .
Pour ajouter une adresse à la liste, le pilote de protocole peut utiliser la requête OID OID_802_3_ADD_MULTICAST_ADDRESS .
Le pilote de protocole overlying peut ajouter une adresse de multidiffusion donnée plusieurs fois en envoyant plusieurs requêtes OID OID_802_3_ADD_MULTICAST_ADDRESS . 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 de dépassement doit supprimer l’adresse le même nombre de fois qu’il a ajouté l’adresse.
Retourner les codes status
La fonction MiniportOidRequest du pilote miniport retourne l’une des valeurs suivantes pour cette requête :
| Terme | Description |
|---|---|
NDIS_STATUS_SUCCESS |
Le pilote miniport a effectué la demande avec succès. |
NDIS_STATUS_PENDING |
Le pilote miniport termine la requête de manière asynchrone. Une fois que le pilote miniport a terminé tout le traitement, il doit réussir la demande en appelant la fonction NdisMOidRequestComplete , en passant NDIS_STATUS_SUCCESS pour le paramètre Status . |
NDIS_STATUS_NOT_ACCEPTED |
Le pilote miniport est en cours de réinitialisation. |
NDIS_STATUS_REQUEST_ABORTED |
Le pilote miniport a cessé de traiter la demande. Par exemple, NDIS a appelé la fonction MiniportResetEx . |
Spécifications
En-tête |
Ntddndis.h (inclure Ndis.h) |