OID_802_3_ADD_MULTICAST_ADDRESS
Como uma solicitação definida, os drivers de protocolo NDIS e overlying usam a solicitação OID OID_802_3_ADD_MULTICAST_ADDRESS para adicionar um endereço multicast 802.3 à lista de endereços multicast de um adaptador de miniporto. O endereço multicast é uma matriz de 6 bytes. Adicionar um endereço permite que esse endereço receba pacotes multicast.
informações de versão
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 adicionado à lista de endereços 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 sobreposto deve emitir várias solicitações de OID OID_802_3_ADD_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 de OID_802_3_ADD_MULTICAST_ADDRESS e OID_802_3_DELETE_MULTICAST_ADDRESS em uma única solicitação OID OID_802_3_MULTICAST_LIST, que ele envia para o driver de miniporto.
Para receber pacotes multicast, o driver em excesso deve usar o OID OID_GEN_CURRENT_PACKET_FILTER para definir o filtro de pacote NDIS_PACKET_TYPE_MULTICAST sinalizador.
O driver de miniporto pode definir um limite no número de endereços multicast que a lista de endereços multicast pode conter. Para especificar o número máximo de endereços multicast, o driver de miniporto define o MaxMulticastListSize membro da estrutura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES que ele passa para a funçãoNdisMSetMiniportAttributes. Para drivers de miniport que se baseiam em versões do NDIS antes do 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 retornará NDIS_STATUS_MULTICAST_FULL se uma solicitação de OID_802_3_ADD_MULTICAST_ADDRESS exceder esse limite.
Para excluir um endereço multicast adicionado anteriormente, faça uma solicitação definida com o OID OID_802_3_DELETE_MULTICAST_ADDRESS. O driver em excesso pode adicionar um determinado endereço multicast várias vezes. 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.
Requisitos
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |
Consulte também
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES