NDIS_CO_CLIENT_OPTIONAL_HANDLERS-Struktur (ndis.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.0 und höher. |
| Kopfzeile | ndis.h (einschließlich Ndis.h) |