NDIS_CO_CLIENT_OPTIONAL_HANDLERS Struktur (ndis.h)
Die NDIS_CO_CLIENT_OPTIONAL_HANDLERS-Struktur gibt Einstiegspunkte für coNDIS-Client-ProtocolXxx--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;
Angehörige
Header
Die NDIS_OBJECT_HEADER Struktur für die CoNDIS-Eigenschaftenstruktur des Protokolltreibers (NDIS_CO_CLIENT_OPTIONAL_HANDLERS). Der Treiber legt den
Element vom Typ der Struktur, die Header- angibt, NDIS_OBJECT_TYPE_CO_CLIENT_OPTIONAL_HANDLERS, das element Revision NDIS_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1 und das element Size 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 Anrufers ProtocolCoOidRequest Funktion.
ClOidRequestCompleteHandler
Der Einstiegspunkt des Anrufers ProtocolCoOidRequestComplete Funktion.
ClOpenAfCompleteHandlerEx
Der Einstiegspunkt des Anrufers ProtocolClOpenAfCompleteEx--Funktion.
ClCloseAfCompleteHandler
Der Einstiegspunkt des Anrufers ProtocolClCloseAfComplete Funktion.
ClRegisterSapCompleteHandler
Der Einstiegspunkt des Anrufers ProtocolClRegisterSapComplete-Funktion. Ein Client verwendet diese Funktion, um eingehende Anrufe von Remotecomputern zu akzeptieren.
ClDeregisterSapCompleteHandler
Der Einstiegspunkt des Anrufers ProtocolClDeregisterSapComplete--Funktion.
ClMakeCallCompleteHandler
Der Einstiegspunkt des Anrufers ProtocolClMakeCallComplete--Funktion. Ein Client verwendet diese Funktion, um ausgehende Anrufe an Remotecomputer zu tätigen.
ClModifyCallQoSCompleteHandler
Der Einstiegspunkt des Anrufers ProtocolClModifyCallQoSComplete-Funktion. Ein Client verwendet diese Funktion, um änderungen der Dienstqualität (Quality of Service, QoS) in einer eingerichteten virtuellen Verbindung (VC) dynamisch vorzunehmen oder mit dem Anrufmanager zu verhandeln, um den QoS einzurichten, wenn der Client einen eingehenden Anruf einrichtet.
ClCloseCallCompleteHandler
Der Einstiegspunkt des Anrufers ProtocolClCloseCallComplete-Funktion.
ClAddPartyCompleteHandler
Der Einstiegspunkt des Anrufers ProtocolClAddPartyComplete-Funktion. Ein Client verwendet diese Funktion, um Point-to-Multipoint-VCs für ausgehende Anrufe an Remotecomputer einzurichten.
ClDropPartyCompleteHandler
Der Einstiegspunkt des Anrufers ProtocolClDropPartyComplete Funktion.
ClIncomingCallHandler
Der Einstiegspunkt des Anrufers ProtocolClIncomingCall-Funktion. Ein Client verwendet diese Funktion, um eingehende Anrufe von Remotecomputern zu akzeptieren.
ClIncomingCallQoSChangeHandler
Der Einstiegspunkt des Anrufers 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 Anrufers ProtocolClIncomingCloseCall-Funktion.
ClIncomingDropPartyHandler
Der Einstiegspunkt des Anrufers ProtocolClIncomingDropParty Funktion.
ClCallConnectedHandler
Der Einstiegspunkt des Anrufers ProtocolClCallConnected-Funktion. Ein Client verwendet diese Funktion, um eingehende Anrufe von Remotecomputern zu akzeptieren.
ClNotifyCloseAfHandler
Der Einstiegspunkt des Anrufers ProtocolClNotifyCloseAf Funktion.
Bemerkungen
Um Einstiegspunkte als CoNDIS-Client anzugeben, initialisiert ein Protokolltreiber eine NDIS_CO_CLIENT_OPTIONAL_HANDLERS Struktur und übergibt sie an die NdisSetOptionalHandlers Funktion.
Der Client ruft NdisSetOptionalHandlers aus der ProtocolSetOptions--Funktion auf. Der Client muss jedes Cl-Xxx--Mitglied in der NDIS_CO_CLIENT_OPTIONAL_HANDLERS-Struktur auf eine vom Aufrufer bereitgestellte ProtocolXxx--Funktion festlegen, auch wenn der Anrufmanager eingehende Anrufe, ausgehende Anrufe oder Point-to-Multipoint-Verbindungen nicht unterstützt. Für jede Teilmenge von verbindungsorientierten Funktionen, die ein Client nicht unterstützt, sollte der Platzhalter ProtocolXxx--Funktionen NDIS_STATUS_NOT_SUPPORTED zurückgeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Header- | ndis.h (include Ndis.h) |