Функция NdisMCmDeleteVc (ndis.h)
NdisMCmDeleteVc уничтожает созданный вызывающим абонентом VC.
Синтаксис
NDIS_STATUS NdisMCmDeleteVc(
[in] NDIS_HANDLE NdisVcHandle
);
Параметры
[in] NdisVcHandle
Указывает дескриптор, определяющий удаляемую VC. Вызывающий объект изначально получил этот дескриптор из NdisMCmCreateVc.
Возвращаемое значение
NdisMCmDeleteVc может возвращать одно из следующих элементов:
| Код возврата | Описание |
|---|---|
|
NDIS удалил VC. |
|
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) |