Функция NdisCmDispatchIncomingDropParty (ndis.h)
NdisCmDispatchIncomingDropParty уведомляет клиента о том, что он должен удалить определенную сторону в многоточечных VC, как правило, так как диспетчер вызовов получил запрос по сети для закрытия активного многоточечных подключений.
Синтаксис
void NdisCmDispatchIncomingDropParty(
[in] NDIS_STATUS DropStatus,
[in] NDIS_HANDLE NdisPartyHandle,
[in, optional] PVOID Buffer,
[in] UINT Size
);
Параметры
[in] DropStatus
Указывает причину, по которой эта сторона удаляется, обычно NDIS_STATUS_SUCCESS, если удаленная сторона просто попросила, чтобы его подключение было закрыто.
[in] NdisPartyHandle
Указывает дескриптор, определяющий сторону, которую нужно удалить из многоточия VC, которая должна иметь другие стороны, которые по-прежнему подключены.
[in, optional] Buffer
Указатель на выделенный абонентом буфер резидента, содержащий дополнительные данные, относящиеся к протоколу, полученные от удаленной стороны, если таковые есть. В зависимости от базового носителя этот указатель может быть null.
[in] Size
Задает размер в байтах буфера, ноль, если буфер имеет значение NULL .
Возвращаемое значение
Никакой
Замечания
В ходе обычных сетевых операций автономный диспетчер вызовов ProtocolCoReceiveNetBufferLists вызовы функций NdisCmDispatchIncomingDropParty с CloseStatus NDIS_STATUS_SUCCESS, так как удаленный клиент на многоточечных подключениях вызвал NdisCloseCall.
Однако диспетчер вызовов также может вызывать NdisCmDispatchIncomingDropPart y с определяемой CM CloseStatus при возникновении ненормальных сетевых условий, таких как сбой переключения между локальным клиентом и одним или несколькими клиентами в установленном многоточном подключении.
Вызов NdisCmDispatchIncomingDropPart y приводит к вызову NDIS клиента функция ProtocolClIncomingDropParty.
Если NdisPartyHandle идентифицирует последнюю оставшуюся сторону в заданном VC, cm вызывает NdisCmDispatchIncomingCloseCall, а не NdisCmDispatchIncomingDropParty.
Только автономные диспетчеры вызовов, которые регистрируют себя в качестве драйверов протокола NDIS, могут вызывать NdisCmDispatchIncomingDropParty. Драйверы минипорта, ориентированные на подключение, обеспечивающие встроенную поддержку управления вызовами, вызовы NdisMCmDispatchIncomingDropParty.