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

Статья
02/26/2024

NdisMCoActivateVcComplete уведомляет NDIS и диспетчер вызовов о том, что драйвер мини-порта завершил обработку инициированного CM-запроса activate-VC, для которого драйвер минипорта ранее вернул NDIS_STATUS_PENDING.

Синтаксис

void NdisMCoActivateVcComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Параметры

[in] Status

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

[in] NdisVcHandle

Указывает дескриптор, определяющий VC. Вызывающий объект получил этот дескриптор из своего состояния per-VC, обозначенного miniportVcContext, переданного в качестве входного параметра в его Функция MiniportCoActivateVc .

[in] CallParameters

Указатель на структуру типа CO_CALL_PARAMETERS, предоставляемую диспетчером вызовов, с указанием параметров вызова и носителя для активации VC.

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

None

Remarks

Драйвер мини-порта, ориентированный на подключение, должен вызывать NdisMCoActivateVcComplete, если его функция MiniportCoActivateVc ранее возвращала NDIS_STATUS_PENDING в ответ на запрос на активацию или повторную активацию VC, определенного указанным NdisVcHandle . Диспетчер вызовов, который инициировал активацию VC с помощью вызова NdisCmActivateVc, не может уведомить NDIS или его клиент о том, можно ли выполнить передачу в VC с помощью указанных параметров вызова, пока драйвер мини-порта не вызовет NdisMCoActivateVcComplete.

Если драйвер минипорта считает предоставленные CM параметры вызова неприемлемыми, он завершает активацию VC при вызове NdisMCoActivateVcComplete. Сбой начальной активации VC может привести к тому, что протокол, создавший VC, разорвет его. Если драйвер мини-порта не выполняет запрос на повторную активацию установленного VC с новыми параметрами вызова, он должен восстановить исходные параметры вызова, установленные для этого VC. В зависимости от характера сетевого носителя драйвер мини-порта может изменять параметры мультимедиа, если перед вызовом NdisMCoActivateVcComplete установлены флаги округления вверх и(или) округления вниз.

Вызов NdisMCoActivateVcComplete приводит к тому, что NDIS вызывает Функция ProtocolCmActivateVcComplete диспетчера вызовов, который первоначально запросил активацию VC.

Требования

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

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

ProtocolCmActivateVcComplete