структура NDIS_CO_CLIENT_OPTIONAL_HANDLERS (ndis.h)
Структура 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 .
Комментарии
Чтобы указать точки входа в качестве клиента CoNDIS, драйвер протокола инициализирует структуру NDIS_CO_CLIENT_OPTIONAL_HANDLERS и передает ее вФункция NdisSetOptionalHandlers.
Клиент вызывает NdisSetOptionalHandlers из функции ProtocolSetOptions . Клиент должен задать каждому элементу ClXxx в структуре NDIS_CO_CLIENT_OPTIONAL_HANDLERS функцию ProtocolXxx , предоставляемую вызывающим абонентом, даже если диспетчер вызовов не поддерживает входящие вызовы, исходящие вызовы или подключения типа "точка — многоточечная точка". Для любого подмножества функций, ориентированных на подключение, которые клиент не поддерживает, его функции-заполнители ProtocolXxx должны возвращать NDIS_STATUS_NOT_SUPPORTED.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается в NDIS 6.0 и более поздних версиях. |
| Верхняя часть | ndis.h (включая Ndis.h) |