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

  • Статья

NdisCmRegisterSapComplete возвращает окончательное состояние запроса клиента, для которого CM ранее вернула NDIS_STATUS_PENDING, для регистрации SAP.

Синтаксис

void NdisCmRegisterSapComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisSapHandle,
  [in] NDIS_HANDLE CallMgrSapContext
);

Параметры

[in] Status

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

[in] NdisSapHandle

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

[in] CallMgrSapContext

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

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

None

Remarks

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

Если диспетчер вызовов задает для параметра Status значение, отличное от NDIS_STATUS_SUCCESS, он должен считать NdisSapHandle недопустимым при вызове NdisCmRegisterSapComplete. После сбоя регистрации SAP CM может освободить или повторно использовать область контекста для КАЖДОГО SAP, выделенную при возврате NdisCmRegisterSapComplete элемента управления. NDIS также освобождает свой контекст для SAP, если диспетчер вызовов не проходит регистрацию.

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

Требования

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

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

NdisAllocateFromNPagedLookasideList

NdisClRegisterSap

NdisMCmRegisterSapComplete

ProtocolClRegisterSapComplete

ProtocolCmRegisterSap