Функция NdisCmDropPartyComplete (ndis.h)

  • Статья

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

Синтаксис

void NdisCmDropPartyComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisPartyHandle
);

Параметры

[in] Status

Указывает окончательное состояние запрошенной операции, NDIS_STATUS_SUCCESS или любой определяемый CM NDIS_STATUS_ XXX , за исключением NDIS_STATUS_PENDING.

[in] NdisPartyHandle

Указывает дескриптор стороны, которую клиент запросил на удаление. Диспетчер вызовов получил этот дескриптор из области состояния, назначенной CallMgrPartyContext , которая была передана в качестве входного параметра в его Функция ProtocolCmDropParty .

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

None

Remarks

Автономный диспетчер вызовов должен вызывать NdisCmDropPartyComplete, если его функция ProtocolCmDropParty ранее возвращала NDIS_STATUS_PENDING для заданного NdisPartyHandle . Ни NDIS, ни клиент, который инициировал операцию drop-party с помощью вызова NdisClDropParty, не может освободить ресурсы, выделенные для поддержания состояния каждой стороны, пока вызов CM к NdisCmDropPartyComplete не вызовет вызов этого клиента. Функция ProtocolClDropPartyComplete .

Если он передает NDIS_STATUS_SUCCESS для состояния, диспетчер вызовов должен считать NdisPartyHandle недопустимым сразу после вызова NdisCmDropPartyComplete. Cm может освободить (или повторно инициализировать для повторного использования) все ресурсы, выделенные для поддержания состояния для этой стороны, когда NdisCmDropPartyComplete возвращает управление.

Вызывать NdisCmDropPartyComplete могут только автономные диспетчеры вызовов, которые регистрируют себя в NDIS в качестве драйверов протоколов. Драйверы мини-портов, ориентированные на подключение, которые обеспечивают встроенную поддержку управления звонками, вызывают вместо этого NdisMCmDropPartyComplete .

Требования

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

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

NdisClDropParty

NdisMCmDropPartyComplete

ProtocolClDropPartyComplete

ProtocolCmDropParty