структура NDIS_CO_CLIENT_OPTIONAL_HANDLERS (ndis.h)

Статья
02/26/2024

Структура NDIS_CO_CLIENT_OPTIONAL_HANDLERS указывает точки входа для функций Протокола Клиента CoNDISXxx для драйвера протокола, который передает эту структуру вФункция NdisSetOptionalHandlers.

Синтаксис

typedef struct _NDIS_CO_CLIENT_OPTIONAL_HANDLERS {
  NDIS_OBJECT_HEADER                  Header;
  ULONG                               Reserved;
  CO_CREATE_VC_HANDLER                ClCreateVcHandler;
  CO_DELETE_VC_HANDLER                ClDeleteVcHandler;
  CO_OID_REQUEST_HANDLER              ClOidRequestHandler;
  CO_OID_REQUEST_COMPLETE_HANDLER     ClOidRequestCompleteHandler;
  CL_OPEN_AF_COMPLETE_HANDLER_EX      ClOpenAfCompleteHandlerEx;
  CL_CLOSE_AF_COMPLETE_HANDLER        ClCloseAfCompleteHandler;
  CL_REG_SAP_COMPLETE_HANDLER         ClRegisterSapCompleteHandler;
  CL_DEREG_SAP_COMPLETE_HANDLER       ClDeregisterSapCompleteHandler;
  CL_MAKE_CALL_COMPLETE_HANDLER       ClMakeCallCompleteHandler;
  CL_MODIFY_CALL_QOS_COMPLETE_HANDLER ClModifyCallQoSCompleteHandler;
  CL_CLOSE_CALL_COMPLETE_HANDLER      ClCloseCallCompleteHandler;
  CL_ADD_PARTY_COMPLETE_HANDLER       ClAddPartyCompleteHandler;
  CL_DROP_PARTY_COMPLETE_HANDLER      ClDropPartyCompleteHandler;
  CL_INCOMING_CALL_HANDLER            ClIncomingCallHandler;
  CL_INCOMING_CALL_QOS_CHANGE_HANDLER ClIncomingCallQoSChangeHandler;
  CL_INCOMING_CLOSE_CALL_HANDLER      ClIncomingCloseCallHandler;
  CL_INCOMING_DROP_PARTY_HANDLER      ClIncomingDropPartyHandler;
  CL_CALL_CONNECTED_HANDLER           ClCallConnectedHandler;
  CL_NOTIFY_CLOSE_AF_HANDLER          ClNotifyCloseAfHandler;
} NDIS_CO_CLIENT_OPTIONAL_HANDLERS, *PNDIS_CO_CLIENT_OPTIONAL_HANDLERS;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры характеристик CoNDIS драйвера протокола (NDIS_CO_CLIENT_OPTIONAL_HANDLERS). Драйвер задает
Элемент типа структуры, задающий заголовок NDIS_OBJECT_TYPE_CO_CLIENT_OPTIONAL_HANDLERS, член редакции для NDIS_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1 и элемент Size для NDIS_SIZEOF_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1.

Reserved

Зарезервировано для NDIS.

ClCreateVcHandler

Точка входа функции ProtocolCoCreateVc вызывающего объекта.

ClDeleteVcHandler

Точка входа функции ProtocolCoDeleteVc вызывающего объекта.

ClOidRequestHandler

Точка входа вызывающего объекта Функция ProtocolCoOidRequest .

ClOidRequestCompleteHandler

Точка входа вызывающего объектаФункция ProtocolCoOidRequestComplete.

ClOpenAfCompleteHandlerEx

Точка входа вызывающего объекта Функция ProtocolClOpenAfCompleteEx .

ClCloseAfCompleteHandler

Точка входа вызывающего объекта Функция ProtocolCloseAfComplete .

ClRegisterSapCompleteHandler

Точка входа вызывающего объекта Функция ProtocolClRegisterSapComplete . Клиент использует эту функцию для приема входящих вызовов с удаленных компьютеров.

ClDeregisterSapCompleteHandler

Точка входа вызывающего объекта Функция ProtocolClDeregisterSapComplete .

ClMakeCallCompleteHandler

Точка входа вызывающего объекта Функция ProtocolClMakeCallComplete . Клиент использует эту функцию для исходящих вызовов удаленных компьютеров.

ClModifyCallQoSCompleteHandler

Точка входа вызывающего объекта Функция ProtocolClModifyCallQoSComplete . Клиент использует эту функцию для динамического внесения изменений в качество обслуживания (QoS) при установленном виртуальном подключении (VC) или для согласования с диспетчером вызовов для установления качества обслуживания при настройке клиентом входящего вызова.

ClCloseCallCompleteHandler

Точка входа вызывающего объекта Функция ProtocolCloseCallComplete .

ClAddPartyCompleteHandler

Точка входа вызывающего объекта Функция ProtocolClAddPartyComplete . Клиент использует эту функцию для установки виртуальных машин типа "точка — многоточечная" для исходящих вызовов удаленных компьютеров.

ClDropPartyCompleteHandler

Точка входа вызывающего объекта Функция ProtocolClDropPartyComplete .

ClIncomingCallHandler

Точка входа вызывающего объекта Функция ProtocolClIncomingCall . Клиент использует эту функцию для приема входящих вызовов с удаленных компьютеров.

ClIncomingCallQoSChangeHandler

Точка входа вызывающего объекта Функция ProtocolClIncomingCallQoSChange . Клиент использует эту функцию для приема входящих вызовов с удаленных компьютеров, на которых отправляющий клиент может динамически изменять качество обслуживания.

ClIncomingCloseCallHandler

Точка входа вызывающего объекта Функция ProtocolClIncomingCloseCall .

ClIncomingDropPartyHandler

Точка входа вызывающего объекта Функция ProtocolClIncomingDropParty .

ClCallConnectedHandler

Точка входа вызывающего объекта Функция ProtocolClCallConnected . Клиент использует эту функцию для приема входящих вызовов с удаленных компьютеров.

ClNotifyCloseAfHandler

Точка входа вызывающего объекта Функция ProtocolClNotifyCloseAf .

Клиент вызывает NdisSetOptionalHandlers из функции ProtocolSetOptions . Клиент должен задать каждому элементу ClXxx в структуре NDIS_CO_CLIENT_OPTIONAL_HANDLERS функцию ProtocolXxx , предоставляемую вызывающим абонентом, даже если диспетчер вызовов не поддерживает входящие вызовы, исходящие вызовы или подключения типа "точка — многоточечная точка". Для любого подмножества функций, ориентированных на подключение, которые клиент не поддерживает, его функции-заполнители ProtocolXxx должны возвращать NDIS_STATUS_NOT_SUPPORTED.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Верхняя часть	ndis.h (включая Ndis.h)