Функция 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. Если состояния задано значение, отличное от NDIS_STATUS_SUCCESS, NDIS игнорирует этот параметр.

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

Никакой

Замечания

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

Если диспетчер вызовов задает status значение, отличное от NDIS_STATUS_SUCCESS, следует учитывать NdisSapHandle недопустимым, как только он вызывает NdisCmRegisterSapComplete. После сбоя регистрации SAP CM может освободить или повторно использовать область контекста SAP, выделенную при NdisCmRegisterSapComplete возвращает элемент управления. NDIS также освобождает его контекст для SAP, если диспетчер вызовов завершается сбоем регистрации.

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

Требования

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

См. также

NdisAllocateFromNPagedLookasideList

NdisClRegisterSap

NdisMCmRegisterSapComplete

ProtocolClRegisterSapComplete

ProtocolCmRegisterSap