Макрос 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)

См. также раздел

MiniportInterruptDPC

NdisClDropParty

NdisCmDispatchIncomingDropParty NdisMCmDispatchIncomingCloseCall

ProtocolClIncomingDropParty