OID_802_3_ADD_MULTICAST_ADDRESS

Como uma solicitação definida, o NDIS e os drivers de protocolo sobrepostos usam a solicitação OID OID_802_3_ADD_MULTICAST_ADDRESS para adicionar um endereço de multicast 802.3 à lista de endereços de multicast de um adaptador de miniporta. O endereço multicast é uma matriz de 6 bytes. Adicionar um endereço permite que esse endereço receba pacotes 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 adicionado à lista de endereços de multicast.

A solicitação OID OID_802_3_ADD_MULTICAST_ADDRESS pode adicionar apenas um endereço. Para adicionar mais de um endereço, o driver sobrejacente deve emitir várias solicitações OID OID_802_3_ADD_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_802_3_ADD_MULTICAST_ADDRESS e OID_802_3_DELETE_MULTICAST_ADDRESS OID em uma única solicitação OID OID_802_3_MULTICAST_LIST, que ele envia para o driver de miniporta.

Para receber pacotes multicast, o driver sobrejacente deve usar o OID_GEN_CURRENT_PACKET_FILTER OID para definir o filtro de pacotes NDIS_PACKET_TYPE_MULTICAST sinalizador.

O driver de miniporta pode definir um limite no número de endereços de multicast que a lista de endereços de multicast pode conter. Para especificar o número máximo de endereços de multicast, o driver de miniporta define o MaxMulticastListSize membro da estrutura de NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES que ele passa para a funçãoNdisMSetMiniportAttributes. Para drivers de miniporta baseados em versões NDIS anteriores ao NDIS 6.0, o NDIS consulta o número máximo de endereços multicast enviando uma solicitação OID OID_802_3_MAXIMUM_LIST_SIZE. O NDIS retorna NDIS_STATUS_MULTICAST_FULL se uma solicitação de OID_802_3_ADD_MULTICAST_ADDRESS exceder esse limite.

Para excluir um endereço de multicast adicionado anteriormente, faça uma solicitação de conjunto com o OID_802_3_DELETE_MULTICAST_ADDRESS OID. O driver sobreposto pode adicionar um determinado endereço de multicast várias vezes. 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.