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

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

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

Никакой

Замечания

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

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

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

Требования

См. также

NdisClRegisterSap

NdisCmRegisterSapComplete

NdisMCmDispatchIncomingCall

ProtocolCmRegisterSap