Поделиться через

OID_802_3_DELETE_MULTICAST_ADDRESS

  • Статья

В качестве запроса набора NDIS и драйверы протоколов с помощью OID_802_3_DELETE_MULTICAST_ADDRESS OID удаляют ранее добавленный адрес многоадресной рассылки из списка адресов многоадресной рассылки мини-адаптера. Адрес многоадресной рассылки — это массив из 6 байт. Удаление адреса отключает этот адрес, чтобы он больше не смог получать многоадресные пакеты.

сведения о версиях

Windows Vista
Поддержанный.

драйверы минипорта NDIS 6.0 и более поздних версий
Не запрашивается.

Замечания

Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит 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 будет успешно выполнять все последующие запросы на добавление этого адреса. Чтобы удалить адрес многоадресной рассылки, добавленный более одного раза, драйверу переопределения необходимо удалить адрес одинаковое количество раз, когда он добавил адрес.

Коды состояния возврата

Функция miniport driver MiniportOidRequest возвращает одно из следующих значений для этого запроса:

Срок Описание

NDIS_STATUS_SUCCESS

Минипорт-драйвер успешно завершил запрос.

NDIS_STATUS_PENDING

Минипорт-драйвер завершит запрос асинхронно. После завершения всей обработки минипорт-драйвера запрос должен завершиться путем вызова функции NdisMOidRequestComplete, передав NDIS_STATUS_SUCCESS для параметра состояния.

NDIS_STATUS_NOT_ACCEPTED

Драйвер минипорта сбрасывается.

NDIS_STATUS_REQUEST_ABORTED

Минипорт-драйвер перестал обрабатывать запрос. Например, NDIS называется функцией MiniportResetEx.

Требования

Заголовок

 Ntddndis.h (include Ndis.h)

См. также

OID_802_3_ADD_MULTICAST_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_MULTICAST_LIST