Макрос NdisMCmDispatchIncomingDropParty (ndis.h)
NdisMCmDispatchIncomingDropParty уведомляет клиента о том, что ему следует удалить определенную сторону в многоточественном VC.
Синтаксис
void NdisMCmDispatchIncomingDropParty(
_S_,
_H_,
_B_,
_Z_
);
Параметры
_S_
Указывает причину удаления этой стороны, обычно NDIS_STATUS_SUCCESS, если удаленная сторона просто попросила закрыть ее подключение.
_H_
Указывает дескриптор, определяющий сторону, удаляемую из многоточечных VC, которая должна иметь другие стороны, которые по-прежнему подключены. Драйвер MCM изначально получил этот дескриптор в качестве входного параметра для функции ProtocolCmAddParty .
_B_
Указатель на выделенный вызывающим абонентом резидентный буфер, содержащий дополнительные данные, относящиеся к протоколу, полученные от удаленной стороны, если таковые есть. В зависимости от базового носителя этот указатель может иметь значение NULL.
_Z_
Указывает размер буфера в байтах, если буфер имеет значение NULL.
Возвращаемое значение
None
Remarks
В ходе обычных сетевых операций драйвер MCM вызывает NdisMCmDispatchIncomingDropParty с параметром CloseStatus , для которого задано значение NDIS_STATUS_SUCCESS так как удаленный клиент при многоточечных подключениях вызвал NdisCloseCall.
Однако драйвер MCM также может вызывать NdisMCmDispatchIncomingDropParty с определяемой драйвером CloseStatus по распоряжению самой сети, если возникают аномальные сетевые условия, такие как сбой коммутатора на пути между локальным клиентом и одним или несколькими клиентами по установленному многоточечным подключению.
Вызов NdisMCmDispatchIncomingDropParty приводит к тому, что NDIS вызывает клиент Функция ProtocolClIncomingDropParty .
Если NdisPartyHandle определяет последнюю оставшуюся сторону в заданном VC, драйвер MCM вызывает NdisMCmDispatchIncomingCloseCall, а не NdisMCmDispatchIncomingDropParty.
Вызывать NdisMCmDispatchIncomingDropParty могут только драйверы минипорта, ориентированные на подключение, которые обеспечивают встроенную поддержку управления вызовами. Автономные диспетчеры вызовов, которые регистрируют себя в NDIS в качестве драйверов протокола, вместо этого вызывают NdisCmDispatchIncomingDropParty .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisMCmDispatchIncomingDropParty (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisMCmDispatchIncomingDropParty (NDIS 5.1)) в Windows XP. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ndis.h (включая Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
| Правила соответствия DDI | Irql_MCM_Function(ndis) |