Condividi tramite


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

Windows Vista
Supportata.

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)

Vedi anche

OID_802_3_ADD_MULTICAST_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_MULTICAST_LIST