Макрос NdisMCmRegisterSapComplete (ndis.h)

Статья
08/07/2023

NdisMCmRegisterSapComplete возвращает окончательное состояние запроса клиента, для которого драйвер MCM

Функция ProtocolCmRegisterSap ранее возвращала NDIS_STATUS_PENDING для регистрации SAP.

Синтаксис

void NdisMCmRegisterSapComplete(
   _S_,
   _H_,
   _C_
);

Параметры

_S_

Указывает окончательное состояние исходного запроса клиента на регистрацию SAP NDIS_STATUS_SUCCESS или любого вызывающего NDIS_STATUS_XXX,за исключением NDIS_STATUS_PENDING.

_H_

Указывает предоставленный NDIS-дескриптор для SAP, если регистрация прошла успешно. Диспетчер вызовов получил этот дескриптор в качестве входного параметра для своей функции ProtocolCmRegisterSap .

_C_

Указывает дескриптор для предоставляемой вызывающей абонентом области контекста, в которой драйвер MCM сохраняет состояние для данной SAP в случае успешной регистрации. Если это так, NDIS передает этот дескриптор обратно в драйвер MCM во всех последующих вызовах, касающихся этого SAP. Если параметр Status имеет значение, отличное от NDIS_STATUS_SUCCESS, NDIS игнорирует этот параметр.

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

None

Remarks

Драйвер MCM должен вызывать NdisMCmRegisterSapComplete, если его функция ProtocolCmRegisterSapSap вернула NDIS_STATUS_PENDING при вызове с заданным NdisSapHandle . Вызов NdisMCmRegisterSapComplete приводит к тому, что NDIS вызывает клиент. Функция ProtocolClRegisterSapComplete .

Если драйвер MCM задает для параметра Status значение, отличное от NDIS_STATUS_SUCCESS, он должен считать NdisSapHandle недопустимым, когда NdisMCmRegisterSapComplete возвращает управление. После неудачной регистрации SAP CM может освободить или повторно использовать уже выделенную область контекста ДЛЯ SAP, если она имеется. NDIS также освобождает свой контекст для SAP, если драйвер MCM не выполняет регистрацию.

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

Требования

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