Partager via


OID_802_3_DELETE_MULTICAST_ADDRESS

En tant que requête définie, les pilotes de protocole NDIS et overlying utilisent l’OID OID_802_3_DELETE_MULTICAST_ADDRESS pour supprimer une adresse de multidiffusion précédemment ajoutée à partir 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 de version

Windows Vista
Supporté.

pilotes miniport NDIS 6.0 et versions ultérieures
Non demandé.

Remarques

Le InformationBuffer membre 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 requête OID. Au lieu de cela, NDIS consolide chaque séquence de requêtes OID OID_802_3_ADD_MULTICAST_ADDRESS et OID_802_3_DELETE_MULTICAST_ADDRESS 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 plusieurs fois une adresse de multidiffusion donnée 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 overlying doit supprimer l’adresse le même nombre de fois qu’elle a ajouté l’adresse.

Retourner des codes d’état

La fonctionminiportdu pilote miniportOidRequest retourne l’une des valeurs suivantes pour cette requête :

Terme Description

NDIS_STATUS_SUCCESS

Le pilote miniport a terminé la requête 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 requête en appelant la fonction NdisMOidRequestComplete, en passant NDIS_STATUS_SUCCESS pour le paramètre Status.

NDIS_STATUS_NOT_ACCEPTED

Le pilote miniport est réinitialisé.

NDIS_STATUS_REQUEST_ABORTED

Le pilote miniport a arrêté le traitement de la requête. Par exemple, NDIS a appelé la fonction MiniportResetEx.

Exigences

En-tête

Ntddndis.h (include Ndis.h)

Voir aussi

OID_802_3_ADD_MULTICAST_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_MULTICAST_LIST