OID_802_3_ADD_MULTICAST_ADDRESS
Come richiesta impostata, i driver di protocollo NDIS e overlying usano la richiesta OID OID_802_3_ADD_MULTICAST_ADDRESS per aggiungere un indirizzo multicast 802.3 all'elenco indirizzi multicast di un adattatore miniport. L'indirizzo multicast è una matrice di 6 byte. L'aggiunta di un indirizzo consente a tale indirizzo di ricevere pacchetti multicast.
Informazioni sulla versione
Driver miniport NDIS 6.0 e versioni successive
Non richiesto.
Commenti
Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene l'indirizzo a 6 byte da aggiungere all'elenco indirizzi multicast.
La richiesta OID OID_802_3_ADD_MULTICAST_ADDRESS può aggiungere un solo indirizzo. Per aggiungere più indirizzi, il driver overlying deve eseguire più richieste OID OID_802_3_ADD_MULTICAST_ADDRESS.
I driver miniport NDIS non ricevono direttamente questa richiesta OID. NDIS consolida invece ogni sequenza di OID_802_3_ADD_MULTICAST_ADDRESS e OID_802_3_DELETE_MULTICAST_ADDRESS richieste OID in una singola richiesta OID OID_802_3_MULTICAST_LIST , che invia al driver miniport.
Per ricevere pacchetti multicast, il driver overlying deve usare l'OID OID_GEN_CURRENT_PACKET_FILTER per impostare il flag di filtro dei pacchetti NDIS_PACKET_TYPE_MULTICAST .
Il driver miniport può impostare un limite sul numero di indirizzi multicast che l'elenco di indirizzi multicast può contenere. Per specificare il numero massimo di indirizzi multicast, il driver miniport imposta il membro MaxMulticastListSize della struttura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES che passa alla funzione NdisMSetMiniportAttributes . Per i driver miniport basati sulle versioni NDIS precedenti a NDIS 6.0, NDIS esegue query sul numero massimo di indirizzi multicast inviando una richiesta OID OID_802_3_MAXIMUM_LIST_SIZE . NDIS restituisce NDIS_STATUS_MULTICAST_FULL se una richiesta di OID_802_3_ADD_MULTICAST_ADDRESS supera questo limite.
Per eliminare un indirizzo multicast aggiunto in precedenza, effettuare una richiesta set con l'OID OID_802_3_DELETE_MULTICAST_ADDRESS . Il driver overlying può aggiungere più volte un determinato indirizzo multicast. Se NDIS ha esito positivo la prima richiesta di aggiunta per un determinato indirizzo multicast, NDIS avrà esito positivo su tutte le richieste di aggiunta successive per tale indirizzo. Per eliminare un indirizzo multicast aggiunto più volte, il driver overlying deve eliminare l'indirizzo lo stesso numero di volte in cui è stato aggiunto l'indirizzo.
Requisiti
Intestazione |
Ntddndis.h (include Ndis.h) |
Vedi anche
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES