Макрос NdisMCmDispatchIncomingDropParty (ndis.h)

NdisMCmDispatchIncomingDropParty уведомляет клиента о том, что он должен удалить определенную сторону в многоточечных VC.

Синтаксис

void NdisMCmDispatchIncomingDropParty(
  _S_,
  _H_,
  _B_,
  _Z_
);

Параметры

_S_

Указывает причину, по которой эта сторона удаляется, обычно NDIS_STATUS_SUCCESS, если удаленная сторона просто попросила, чтобы его подключение было закрыто.

_H_

Указывает дескриптор, определяющий сторону, которую нужно удалить из многоточия VC, которая должна иметь другие стороны, которые по-прежнему подключены. Драйвер MCM первоначально получил этот дескриптор в качестве входного параметра для функции ProtocolCmAddParty.

_B_

Указатель на выделенный абонентом буфер резидента, содержащий дополнительные данные, относящиеся к протоколу, полученные от удаленной стороны, если таковые есть. В зависимости от базового носителя этот указатель может быть null.

_Z_

Задает размер в байтах буфера, ноль, если буфер имеет значение NULL .

Возвращаемое значение

Никакой

Замечания

В ходе обычных сетевых операций драйвер MCM вызывает NdisMCmDispatchIncomingDropPart y с CloseStatus NDIS_STATUS_SUCCESS, так как удаленный клиент на многоточечных подключениях вызвал NdisCloseCall.

Однако драйвер MCM также может вызывать NdisMCmDispatchIncomingDropPart y с определяемой драйвером CloseStatus при возникновении ненормальных сетевых условий, таких как сбой коммутатора между локальным клиентом и одним или несколькими клиентами в установленном многоточечных подключениях.

Вызов NdisMCmDispatchIncomingDropPart y приводит к вызову NDIS для вызова клиента функция ProtocolClIncomingDropParty.

Если NdisPartyHandle идентифицирует последнюю оставшуюся сторону в заданном VC, драйвер MCM вызывает NdisMCmDispatchIncomingCloseCall, а не NdisMCmDispatchIncomingDropParty.

Только драйверы минипорта, ориентированные на подключение, которые обеспечивают встроенную поддержку управления вызовами, могут вызывать NdisMCmDispatchIncomingDropParty. Автономные диспетчеры вызовов, которые регистрируют себя в качестве драйверов протокола NDIS, вызывают NdisCmDispatchIncomingDropParty.

Требования

См. также

MiniportInterruptDPC

NdisClDropParty

ProtocolClIncomingDropParty