NDIS_CO_CLIENT_OPTIONAL_HANDLERS 結構 (ndis.h)

發行項
02/26/2024

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

呼叫端的進入點 ProtocolCloseAfComplete 函式。

ClRegisterSapCompleteHandler

呼叫端的進入點 ProtocolClRegisterSapComplete 函式。用戶端會使用此函式來接受來自遠端電腦的連入呼叫。

ClDeregisterSapCompleteHandler

呼叫端的進入點 ProtocolClDeregisterSapComplete 函式。

ClMakeCallCompleteHandler

呼叫端的進入點 ProtocolClMakeCallComplete 函式。用戶端會使用此函式對遠端電腦進行傳出呼叫。

ClModifyCallQoSCompleteHandler

呼叫端的進入點 ProtocolClModifyCallQoSComplete 函式。用戶端會使用此函式，在已建立的虛擬連線 (VC) 上動態變更服務品質 (QoS) ，或與呼叫管理員交涉，以在用戶端設定傳入呼叫時建立 QoS。

ClCloseCallCompleteHandler

呼叫端的進入點 ProtocolCloseCallComplete 函式。

ClAddPartyCompleteHandler

呼叫端的進入點 ProtocolClAddPartyComplete 函式。用戶端會使用此函式，為遠端電腦的連出呼叫建立點對多點 VM。

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結構中的每個 ClXxx 成員設定為呼叫端提供的 ProtocolXxx 函式，即使呼叫管理員不支援來電、傳出呼叫或點對多點連線也一樣。對於用戶端不支援的任何連線導向功能子集，其佔位符 ProtocolXxx 函式應該會傳回NDIS_STATUS_NOT_SUPPORTED。