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

Статья
08/07/2023

NdisMCmCloseCallComplete возвращает окончательное состояние запроса клиента, для которого драйвер MCM ранее вернул NDIS_STATUS_PENDING, чтобы отменить вызов.

Синтаксис

void NdisMCmCloseCallComplete(
   _S_,
   _VH_,
   _PH_
);

Параметры

_S_

Указывает окончательное состояние запроса клиента на закрытие подключения драйвером MCM, NDIS_STATUS_SUCCESS или любого вызывающего NDIS_STATUS_XXX, за исключением NDIS_STATUS_PENDING.

_VH_

Указывает дескриптор для VC для вызова. Этот дескриптор был предоставлен NDIS при первоначальном создании VC, будь то драйвер MCM с NdisMCmCreateVc или в качестве входного параметра для функции ProtocolCoCreateVc .

_PH_

Указывает значение NULL , если NdisVcHandle представляет собой VC типа "точка — точка" или дескриптор последней оставшейся стороны в многоточечном соединении, которое драйвер MCM получил из своего состояния, определенного callMgrPartyContext , переданного в качестве входного параметра в его Функция ProtocolCmCloseCall .

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

None

Remarks

Если функция ProtocolCmCloseCall драйвера MCM возвращает NDIS_STATUS_PENDING, она должна вызвать NdisMCmCloseCallComplete , чтобы уведомить клиента и NDIS о том, что попытка разорвать подключение завершена, будь то успешно или с ошибкой. Вызов NdisMCmCloseCallComplete вызывает функцию ProtocolClCloseCallComplete клиента.

Если он передает NDIS_STATUS_SUCCESS в качестве состояния, драйвер MCM должен считать NdisVcHandle (и NdisPartyHandle, если таковые есть) непригодными для передачи по сети, как только он вызывает NdisMCmCloseCallComplete. Если драйвер MCM изначально создал VC, он должен вызвать NdisMCmDeleteVc с тем же NdisVcHandle , который он только что передал в NdisMCmCloseCallComplete. Если клиент создал этот VC, драйвер MCM может ожидать вызова функции ProtocolCoDeleteVc с
ProtocolVcContext, обозначающее его состояние VC, в котором хранится тот же NdisVcHandle в качестве входного параметра.

Вызывать NdisMCmCloseCallComplete могут только драйверы минипорта, ориентированные на подключение, которые обеспечивают встроенную поддержку управления вызовами. Автономные диспетчеры вызовов, которые регистрируют себя с помощью NDIS в качестве драйверов протокола, вместо этого вызывают NdisCmCloseCallComplete .

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisMCmCloseCallComplete (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisMCmCloseCallComplete (NDIS 5.1)) в Windows XP.
Целевая платформа	Персональный компьютер
Верхняя часть	ndis.h (включая Ndis.h)
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	Irql_MCM_Function(ndis)