Функция NdisMCoActivateVcComplete (ndis.h)
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) |