OID_802_3_ADD_MULTICAST_ADDRESS
Como uma solicitação definida, os drivers de protocolo NDIS e sobrepostos 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 miniport. O endereço multicast é uma matriz de 6 bytes. Adicionar um endereço permite que esse endereço receba pacotes multicast.
Informações sobre versão
Drivers de miniporte NDIS 6.0 e posterior
Não solicitado.
Comentários
O membro InformationBuffer 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 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 ela envia para o driver de miniporto.
Para receber pacotes multicast, o driver sobreposto 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 membro MaxMulticastListSize da estrutura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES que ele passa para a função NdisMSetMiniportAttributes . Para drivers de miniporte baseados em versões 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_802_3_DELETE_MULTICAST_ADDRESS OID. O driver overlying 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 adicionais subsequentes para esse endereço. Para excluir um endereço multicast que foi adicionado mais de uma vez, o driver subjacente deve excluir o mesmo número de vezes que adicionou o endereço.
Requisitos
parâmetro |
Ntddndis.h (inclua Ndis.h) |
Confira também
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES