Compartilhar via


OID_802_3_DELETE_MULTICAST_ADDRESS

Como uma solicitação definida, o NDIS e os drivers de protocolo sobrepostos usam o OID OID_802_3_DELETE_MULTICAST_ADDRESS para excluir um endereço multicast adicionado anteriormente da lista de endereços multicast de um adaptador de miniporto. O endereço multicast é uma matriz de 6 bytes. Excluir um endereço desabilita esse endereço para que ele não possa mais receber pacotes multicast.

informações de versão

Windows Vista
Suportado.

drivers de miniporto NDIS 6.0 e posterior
Não solicitado.

Observações

O InformationBuffer membro da estrutura NDIS_OID_REQUEST contém o endereço de 6 bytes a ser excluído da lista de endereços multicast.

A solicitação OID OID_802_3_DELETE_MULTICAST_ADDRESS pode excluir apenas um endereço. Para excluir mais de um endereço, o driver de protocolo deve emitir várias solicitações de OID OID_802_3_DELETE_MULTICAST_ADDRESS.

Os drivers de miniporto NDIS não recebem essa solicitação de OID diretamente. Em vez disso, o NDIS consolida cada sequência de solicitações OID OID_802_3_ADD_MULTICAST_ADDRESS e OID_802_3_DELETE_MULTICAST_ADDRESS em uma única solicitação OID OID_802_3_MULTICAST_LIST.

Para substituir ou excluir toda a lista de multicast, o driver de protocolo pode usar o OID_802_3_MULTICAST_LIST solicitação de OID.

Para adicionar um endereço à lista, o driver de protocolo pode usar o OID_802_3_ADD_MULTICAST_ADDRESS solicitação de OID.

O driver de protocolo sobreposto pode adicionar um determinado endereço multicast várias vezes enviando várias solicitações de OID OID_802_3_ADD_MULTICAST_ADDRESS. Se o NDIS tiver êxito na primeira solicitação de adição para um determinado endereço multicast, o NDIS terá êxito em todas as solicitações de adição subsequentes para esse endereço. Para excluir um endereço multicast que foi adicionado mais de uma vez, o driver em excesso deve excluir o endereço o mesmo número de vezes que adicionou o endereço.

Retornar códigos de status

A funçãoMiniportOidRequestdo driver de miniporto retorna um dos seguintes valores para esta solicitação:

Prazo Descrição

NDIS_STATUS_SUCCESS

O driver de miniporto concluiu a solicitação com êxito.

NDIS_STATUS_PENDING

O driver de miniporto concluirá a solicitação de forma assíncrona. Depois que o driver de miniporto tiver concluído todo o processamento, ele deverá ter êxito na solicitação chamando a funçãoNdisMOidRequestComplete, passando NDIS_STATUS_SUCCESS para o parâmetro status do.

NDIS_STATUS_NOT_ACCEPTED

O driver de miniporto está sendo redefinido.

NDIS_STATUS_REQUEST_ABORTED

O driver de miniporto parou de processar a solicitação. Por exemplo, o NDIS chamou a função MiniportResetEx.

Requisitos

Cabeçalho

Ntddndis.h (inclua Ndis.h)

Consulte também

OID_802_3_ADD_MULTICAST_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_MULTICAST_LIST