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

Статья
02/07/2025

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 (include Ndis.h)
библиотеки	Ndis.lib
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	Irql_MCM_Function(ndis)