OID_802_3_DELETE_MULTICAST_ADDRESS
Come richiesta impostata, i driver di protocollo NDIS e overlying usano l'OID OID_802_3_DELETE_MULTICAST_ADDRESS per eliminare un indirizzo multicast aggiunto in precedenza dall'elenco di indirizzi multicast di una scheda miniport. L'indirizzo multicast è una matrice di 6 byte. L'eliminazione di un indirizzo disabilita tale indirizzo in modo che non possa più 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 da 6 byte da eliminare dall'elenco indirizzi multicast.
La richiesta OID OID_802_3_DELETE_MULTICAST_ADDRESS può eliminare un solo indirizzo. Per eliminare più indirizzi, il driver del protocollo deve eseguire più richieste OID OID_802_3_DELETE_MULTICAST_ADDRESS.
I driver miniport NDIS non ricevono direttamente questa richiesta OID. NDIS consolida invece ogni sequenza di richieste OID_802_3_ADD_MULTICAST_ADDRESS e OID_802_3_DELETE_MULTICAST_ADDRESS OID in una singola richiesta OID OID_802_3_MULTICAST_LIST .
Per sostituire o eliminare l'intero elenco multicast, il driver del protocollo può usare la richiesta OID OID_802_3_MULTICAST_LIST .
Per aggiungere un indirizzo all'elenco, il driver del protocollo può usare la richiesta OID OID_802_3_ADD_MULTICAST_ADDRESS .
Il driver del protocollo overlying può aggiungere più volte un determinato indirizzo multicast inviando più richieste OID OID_802_3_ADD_MULTICAST_ADDRESS . 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.
Codici di stato restituiti
La funzione MiniportOidRequest del driver miniport restituisce uno dei valori seguenti per questa richiesta:
| Termine | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
Il driver miniport ha completato correttamente la richiesta. |
NDIS_STATUS_PENDING |
Il driver miniport completa la richiesta in modo asincrono. Dopo aver completato l'elaborazione, il driver miniport deve avere esito positivo alla richiesta chiamando la funzione NdisMOidRequestComplete , passando NDIS_STATUS_SUCCESS per il parametro Status . |
NDIS_STATUS_NOT_ACCEPTED |
Il driver miniport viene reimpostato. |
NDIS_STATUS_REQUEST_ABORTED |
Il driver miniport ha arrestato l'elaborazione della richiesta. Ad esempio, NDIS ha chiamato la funzione MiniportResetEx . |
Requisiti
Intestazione |
Ntddndis.h (include Ndis.h) |