OID_802_3_DELETE_MULTICAST_ADDRESS
Como uma solicitação definida, os drivers de protocolo NDIS e overlying 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 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 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 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 .
Para substituir ou excluir toda a lista multicast, o driver de protocolo pode usar o OID_802_3_MULTICAST_LIST solicitação OID.
Para adicionar um endereço à lista, o driver de protocolo pode usar o OID_802_3_ADD_MULTICAST_ADDRESS solicitação 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 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.
Retornar códigos de status
A função MiniportOidRequest do driver de miniport retorna um dos seguintes valores para esta solicitação:
| Termo | Descrição |
|---|---|
NDIS_STATUS_SUCCESS |
O driver de miniporte concluiu a solicitação com êxito. |
NDIS_STATUS_PENDING |
O driver de miniporte 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ção NdisMOidRequestComplete , passando NDIS_STATUS_SUCCESS para o parâmetro Status . |
NDIS_STATUS_NOT_ACCEPTED |
O driver de miniporte 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
parâmetro |
Ntddndis.h (inclua Ndis.h) |