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

Статья
02/26/2024

NdisMCmDeleteVc уничтожает созданный вызывающим абонентом VC.

Синтаксис

NDIS_STATUS NdisMCmDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Параметры

[in] NdisVcHandle

Указывает дескриптор, определяющий удаляемую VC. Вызывающий объект изначально получил этот дескриптор из NdisMCmCreateVc.

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

NdisMCmDeleteVc может возвращать одно из следующих элементов:

Код возврата	Описание
NDIS_STATUS_SUCCESS	NDIS удалил VC.
NDIS_STATUS_NOT_ACCEPTED	VC по-прежнему активен, поэтому его не удалось удалить.

Когда драйвер MCM вызывает NdisMCmDeleteVc, не должно быть необработанных вызовов в заданном VC, и этот VC должен быть отключен. Для удовлетворения этих требований предполагается, что драйвер MCM уже успешно вызвал NdisMCmDeactivateVc с заданным NdisVcHandle .

Только драйвер, создавший определенный VC, может удалить этот VC. Вызов NdisMCmDeleteVc приводит к тому, что NDIS вызывает функцию ProtocolCoDeleteVc клиента, с которой вызывающий объект использует NdisVcHandle .

Когда NdisMCmDeleteVc возвращает элемент управления, NdisVcHandle становится недействительным. Драйвер MCM может освободить ресурсы, выделенные для поддержания состояния удаленного VC, или подготовить их к повторному использованию в последующем уведомлении о входящем вызове после вызова NdisMCmCreateVc.

Модуль записи драйвера определяет, имеет ли драйвер MCM (внутреннюю) функцию MiniportCoDeleteVc , которую драйвер вызывает в контексте разрыва подключений для исходящих и входящих вызовов.

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

Требования

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