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_CO_CLIENT_OPTIONAL_HANDLERS)에 대한 NDIS_OBJECT_HEADER 구조체입니다. 드라이버는 다음을 설정합니다.
Header가 NDIS_OBJECT_TYPE_CO_CLIENT_OPTIONAL_HANDLERS 지정하는 구조체의 멤버, NDIS_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1 수정 멤버 및 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 함수입니다. 클라이언트는 이 함수를 사용하여 원격 머신에 나가는 호출에 대한 지점 및 다중 지점 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 구조의 모든 ClXxx 멤버를 호출자 제공 ProtocolXxx 함수로 설정해야 합니다. 클라이언트가 지원하지 않는 연결 지향 기능의 하위 집합에 대해 자리 표시자 ProtocolXxx 함수는 NDIS_STATUS_NOT_SUPPORTED 반환해야 합니다.