Функция 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.
Возвращаемое значение
None
Remarks
В ходе обычных сетевых операций автономный диспетчер вызововФункция ProtocolCoReceiveNetBufferLists вызывает NdisCmDispatchIncomingDropParty с параметром CloseStatus, для которого задано значение NDIS_STATUS_SUCCESS, так как удаленный клиент на многоточественном подключении вызывает NdisClCloseCall.
Однако диспетчер вызовов также может вызывать NdisCmDispatchIncomingDropParty с определяемой cm-моделью CloseStatus по запросу самой сети, если возникают аномальные сетевые условия, такие как сбой переключения на пути между локальным клиентом и одним или несколькими клиентами при установленном многоточечковом подключении.
Вызов NdisCmDispatchIncomingDropParty вызывает NDIS для вызова клиента. Функция ProtocolClIncomingDropParty .
Если NdisPartyHandle идентифицирует последнюю оставшуюся сторону в заданном VC, cm вызывает NdisCmDispatchIncomingCloseCall, а не NdisCmDispatchIncomingDropParty.
Вызывать NdisCmDispatchIncomingDropParty могут только автономные диспетчеры вызовов, которые регистрируются в NDIS в качестве драйверов протоколов. Драйверы мини-портов, ориентированные на подключение, которые обеспечивают встроенную поддержку управления звонками, вызывают вместо этого NdisMCmDispatchIncomingDropParty .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisCmDispatchIncomingDropParty (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisCmDispatchIncomingDropParty (NDIS 5.1)) в Windows XP. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ndis.h (включая Ndis.h) |
| Библиотека | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Правила соответствия DDI | Irql_CallManager_Function(ndis) |