NDIS_CO_CLIENT_OPTIONAL_HANDLERS 结构 (ndis.h)

项目
08/07/2023

NDIS_CO_CLIENT_OPTIONAL_HANDLERS 结构为将此结构传递给的协议驱动程序指定 CoNDIS 客户端 ProtocolXxx 函数的入口点 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

协议驱动程序 CoNDIS 特征结构的NDIS_OBJECT_HEADER 结构 (NDIS_CO_CLIENT_OPTIONAL_HANDLERS) 。驱动程序设置
Header 指定要NDIS_OBJECT_TYPE_CO_CLIENT_OPTIONAL_HANDLERS结构的类型成员、要NDIS_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1的 Revision 成员和要NDIS_SIZEOF_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1的 Size 成员。

Reserved

保留给 NDIS。

ClCreateVcHandler

调用方 ProtocolCoCreateVc 函数的入口点。

ClDeleteVcHandler

调用方 ProtocolCoDeleteVc 函数的入口点。

ClOidRequestHandler

调用方的入口点 ProtocolCoOidRequest 函数。

ClOidRequestCompleteHandler

调用方的入口点 ProtocolCoOidRequestComplete 函数。

ClOpenAfCompleteHandlerEx

调用方的入口点 ProtocolClOpenAfCompleteEx 函数。

ClCloseAfCompleteHandler

调用方的入口点 ProtocolClCloseAfComplete 函数。

ClRegisterSapCompleteHandler

调用方的入口点 ProtocolClRegisterSapComplete 函数。客户端使用此函数接受来自远程计算机的传入调用。

ClDeregisterSapCompleteHandler

调用方的入口点 ProtocolClDeregisterSapComplete 函数。

ClMakeCallCompleteHandler

调用方的入口点 ProtocolClMakeCallComplete 函数。客户端使用此函数向远程计算机发出传出调用。

ClModifyCallQoSCompleteHandler

调用方的入口点 ProtocolClModifyCallQoSComplete 函数。客户端使用此函数动态更改已建立的虚拟连接 (VC) (QoS) 的服务质量，或者与调用管理器协商以在客户端设置传入呼叫时建立 QoS。

ClCloseCallCompleteHandler

调用方的入口点 ProtocolClCloseCallComplete 函数。

ClAddPartyCompleteHandler

调用方的入口点 ProtocolClAddPartyComplete 函数。客户端使用此函数为远程计算机的传出调用建立点到多点 VC。

ClDropPartyCompleteHandler

调用方的入口点 ProtocolClDropPartyComplete 函数。

ClIncomingCallHandler

调用方的入口点 ProtocolClIncomingCall 函数。客户端使用此函数接受来自远程计算机的传入调用。

ClIncomingCallQoSChangeHandler

调用方的入口点 ProtocolClIncomingCallQoSChange 函数。客户端使用此函数接受来自远程计算机的传入调用，发送客户端可以在远程计算机上动态更改 QoS。

ClIncomingCloseCallHandler

调用方的入口点 ProtocolClIncomingCloseCall 函数。

ClIncomingDropPartyHandler

调用方的入口点 ProtocolClIncomingDropParty 函数。

ClCallConnectedHandler

调用方的入口点 ProtocolClCallConnected 函数。客户端使用此函数接受来自远程计算机的传入调用。

ClNotifyCloseAfHandler

调用方的入口点 ProtocolClNotifyCloseAf 函数。

注解

若要将入口点指定为 CoNDIS 客户端，协议驱动程序会初始化 NDIS_CO_CLIENT_OPTIONAL_HANDLERS 结构并将其传递给 NdisSetOptionalHandlers 函数。

客户端从 ProtocolSetOptions 函数调用 NdisSetOptionalHandlers。即使调用管理器不支持传入呼叫、传出呼叫或点到多点连接，客户端也必须将 NDIS_CO_CLIENT_OPTIONAL_HANDLERS 结构中的每个 Cl Xxx 成员都设置为调用方提供的 ProtocolXxx 函数。对于客户端不支持的面向连接的功能的子集，其占位符 ProtocolXxx 函数应返回NDIS_STATUS_NOT_SUPPORTED。