NDIS_CO_CLIENT_OPTIONAL_HANDLERS-Struktur (ndis.h)

Artikel
08/07/2023

Die NDIS_CO_CLIENT_OPTIONAL_HANDLERS-Struktur gibt Einstiegspunkte für CoNDIS-ClientprotokollXxx-Funktionen für den Protokolltreiber an, der diese Struktur an die NdisSetOptionalHandlers-Funktion .

Syntax

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;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die CoNDIS-Eigenschaftenstruktur des Protokolltreibers (NDIS_CO_CLIENT_OPTIONAL_HANDLERS). Der Treiber legt die
Geben Sie Member der Struktur ein, die Header für NDIS_OBJECT_TYPE_CO_CLIENT_OPTIONAL_HANDLERS, das Revisionselement für NDIS_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1 und das Size-Element , um NDIS_SIZEOF_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1.

Reserved

Reserviert für NDIS.

ClCreateVcHandler

Der Einstiegspunkt der ProtocolCoCreateVc-Funktion des Aufrufers.

ClDeleteVcHandler

Der Einstiegspunkt der ProtocolCoDeleteVc-Funktion des Aufrufers.

ClOidRequestHandler

Der Einstiegspunkt des Aufrufers ProtocolCoOidRequest-Funktion .

ClOidRequestCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolCoOidRequestComplete-Funktion .

ClOpenAfCompleteHandlerEx

Der Einstiegspunkt des Aufrufers ProtocolClOpenAfCompleteEx-Funktion .

ClCloseAfCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolClCloseAfComplete-Funktion .

ClRegisterSapCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolClRegisterSapComplete-Funktion . Ein Client verwendet diese Funktion, um eingehende Anrufe von Remotecomputern zu akzeptieren.

ClDeregisterSapCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolClDeregisterSapComplete-Funktion .

ClMakeCallCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolClMakeCallComplete-Funktion . Ein Client verwendet diese Funktion, um ausgehende Aufrufe von Remotecomputern zu tätigen.

ClModifyCallQoSCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolClModifyCallQoSComplete-Funktion . Ein Client verwendet diese Funktion, um dynamisch Änderungen an der Dienstqualität (Quality of Service, QoS) für eine etablierte virtuelle Verbindung (VC) vorzunehmen oder mit dem Anruf-Manager zu verhandeln, um die QoS einzurichten, wenn der Client einen eingehenden Anruf einrichtet.

ClCloseCallCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolClCloseCallComplete-Funktion .

ClAddPartyCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolClAddPartyComplete-Funktion . Ein Client verwendet diese Funktion, um Point-to-Multipoint-VCs für ausgehende Aufrufe von Remotecomputern einzurichten.

ClDropPartyCompleteHandler

Der Einstiegspunkt des Aufrufers ProtocolClDropPartyComplete-Funktion .

ClIncomingCallHandler

Der Einstiegspunkt des Aufrufers ProtocolClIncomingCall-Funktion . Ein Client verwendet diese Funktion, um eingehende Anrufe von Remotecomputern zu akzeptieren.

ClIncomingCallQoSChangeHandler

Der Einstiegspunkt des Aufrufers ProtocolClIncomingCallQoSChange-Funktion . Ein Client verwendet diese Funktion, um eingehende Anrufe von Remotecomputern zu akzeptieren, auf denen der sendende Client die QoS dynamisch ändern kann.

ClIncomingCloseCallHandler

Der Einstiegspunkt des Aufrufers ProtocolClIncomingCloseCall-Funktion .

ClIncomingDropPartyHandler

Der Einstiegspunkt des Aufrufers ProtocolClIncomingDropParty-Funktion .

ClCallConnectedHandler

Der Einstiegspunkt des Aufrufers ProtocolClCallConnected-Funktion . Ein Client verwendet diese Funktion, um eingehende Anrufe von Remotecomputern zu akzeptieren.

ClNotifyCloseAfHandler

Der Einstiegspunkt des Aufrufers ProtocolClNotifyCloseAf-Funktion .

Hinweise

Um Einstiegspunkte als CoNDIS-Client anzugeben, initialisiert ein Protokolltreiber eine NDIS_CO_CLIENT_OPTIONAL_HANDLERS-Struktur und übergibt sie an den NdisSetOptionalHandlers-Funktion .

Der Client ruft NdisSetOptionalHandlers über die ProtocolSetOptions-Funktion auf. Der Client muss jedes ClXxx-Element in der NDIS_CO_CLIENT_OPTIONAL_HANDLERS-Struktur auf eine vom Aufrufer bereitgestellte ProtocolXxx-Funktion festlegen, auch wenn der Aufruf-Manager keine eingehenden Aufrufe, ausgehenden Aufrufe oder Point-to-Multipoint-Verbindungen unterstützt. Für jede Teilmenge verbindungsorientierter Funktionen, die ein Client nicht unterstützt, sollten seine Platzhalterfunktionen ProtocolXxx NDIS_STATUS_NOT_SUPPORTED zurückgeben.