OID_802_3_DELETE_MULTICAST_ADDRESS

作为设置请求,NDIS 和 overlying 协议驱动程序使用 OID_802_3_DELETE_MULTICAST_ADDRESS OID 从微型端口适配器的多播地址列表中删除以前添加的多播地址。 多播地址是 6 个字节的数组。 删除地址会禁用该地址,使其无法再接收多播数据包。

版本信息

Windows Vista
支持。

NDIS 6.0 及更高版本的微型端口驱动程序
未请求。

注解

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含要从多播地址列表中删除的 6 字节地址。

OID_802_3_DELETE_MULTICAST_ADDRESS OID 请求只能删除一个地址。 若要删除多个地址,协议驱动程序必须发出多个OID_802_3_DELETE_MULTICAST_ADDRESS OID 请求。

NDIS 微型端口驱动程序不会直接接收此 OID 请求。 相反,NDIS 将 每个OID_802_3_ADD_MULTICAST_ADDRESS 序列和OID_802_3_DELETE_MULTICAST_ADDRESS OID 请求合并到单个 OID_802_3_MULTICAST_LIST OID 请求中。

若要替换或删除整个多播列表,协议驱动程序可以使用 OID_802_3_MULTICAST_LIST OID 请求。

若要将地址添加到列表中,协议驱动程序可以使用 OID_802_3_ADD_MULTICAST_ADDRESS OID 请求。

覆盖协议驱动程序可以通过发送多个 OID_802_3_ADD_MULTICAST_ADDRESS OID 请求来多次添加给定的多播地址。 如果 NDIS 成功执行给定多播地址的第一个添加请求,则 NDIS 将成功针对该地址的所有后续添加请求。 若要删除多次添加的多播地址,覆盖驱动程序必须删除该地址的次数与添加该地址的次数相同。

返回状态代码

微型端口驱动程序的 MiniportOidRequest 函数为此请求返回以下值之一:

术语 说明

NDIS_STATUS_SUCCESS

微型端口驱动程序成功完成了请求。

NDIS_STATUS_PENDING

微型端口驱动程序将以异步方式完成请求。 微型端口驱动程序完成所有处理后,它必须通过调用 NdisMOidRequestComplete 函数、传递 Status 参数NDIS_STATUS_SUCCESS来使请求成功。

NDIS_STATUS_NOT_ACCEPTED

微型端口驱动程序正在重置。

NDIS_STATUS_REQUEST_ABORTED

微型端口驱动程序已停止处理请求。 例如,NDIS 调用 MiniportResetEx 函数。

要求

标头

Ntddndis.h (包括 Ndis.h)

另请参阅

OID_802_3_ADD_MULTICAST_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_MULTICAST_LIST