Partilhar via


OID_802_3_DELETE_MULTICAST_ADDRESS

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

Informações sobre a versão do

Windows Vista
Suportado.

drivers de miniporta NDIS 6.0 e posteriores
Não solicitado.

Comentários

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 de 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 OID OID_802_3_DELETE_MULTICAST_ADDRESS.

Os drivers de miniporta NDIS não recebem essa solicitação 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 a OID_802_3_MULTICAST_LIST solicitação OID.

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

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

Códigos de status de retorno

A funçãoMiniportOidRequest do driver de miniportaretorna um dos seguintes valores para essa solicitação:

Vigência Descrição

NDIS_STATUS_SUCCESS

O driver da miniporta concluiu a solicitação com êxito.

NDIS_STATUS_PENDING

O driver de miniporta concluirá a solicitação de forma assíncrona. Depois que o driver de miniporta tiver concluído todo o processamento, ele deverá executar a solicitação chamando a função NdisMOidRequestComplete e passando NDIS_STATUS_SUCCESS para o parâmetro Status .

NDIS_STATUS_NOT_ACCEPTED

O driver da miniporta está sendo redefinido.

NDIS_STATUS_REQUEST_ABORTED

O driver da miniporta parou de processar a solicitação. Por exemplo, o NDIS chamou a funçãoMiniportResetEx.

Requerimentos

Cabeçalho

Ntddndis.h (inclui Ndis.h)

Ver também

OID_802_3_ADD_MULTICAST_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_MULTICAST_LIST