structure NDIS_CO_CLIENT_OPTIONAL_HANDLERS (ndis.h)

Article
08/07/2023

La structure NDIS_CO_CLIENT_OPTIONAL_HANDLERS spécifie des points d’entrée pour les fonctions ProtocolXxx du client CoNDIS pour le pilote de protocole qui transmet cette structure au Fonction NdisSetOptionalHandlers .

Syntaxe

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;

Membres

Header

Structure NDIS_OBJECT_HEADER pour la structure des caractéristiques CoNDIS du pilote de protocole (NDIS_CO_CLIENT_OPTIONAL_HANDLERS). Le pilote définit le
Tapez membre de la structure que l’en-tête spécifie à NDIS_OBJECT_TYPE_CO_CLIENT_OPTIONAL_HANDLERS, le membre Revision à NDIS_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1 et le membre Size à NDIS_SIZEOF_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1.

Reserved

Réservé à NDIS.

ClCreateVcHandler

Point d’entrée de la fonction ProtocolCoCreateVc de l’appelant.

ClDeleteVcHandler

Point d’entrée de la fonction ProtocolCoDeleteVc de l’appelant.

ClOidRequestHandler

Point d’entrée de l’appelant Fonction ProtocolCoOidRequest .

ClOidRequestCompleteHandler

Point d’entrée de l’appelant Fonction ProtocolCoOidRequestComplete .

ClOpenAfCompleteHandlerEx

Point d’entrée de l’appelant Fonction ProtocolClOpenAfCompleteEx .

ClCloseAfCompleteHandler

Point d’entrée de l’appelant Fonction ProtocolClCloseAfComplete .

ClRegisterSapCompleteHandler

Point d’entrée de l’appelant Fonction ProtocolClRegisterSapComplete . Un client utilise cette fonction pour accepter les appels entrants provenant de machines distantes.

ClDeregisterSapCompleteHandler

Point d’entrée de l’appelant Fonction ProtocolClDeregisterSapComplete .

ClMakeCallCompleteHandler

Point d’entrée de l’appelant Fonction ProtocolClMakeCallComplete . Un client utilise cette fonction pour effectuer des appels sortants vers des machines distantes.

ClModifyCallQoSCompleteHandler

Point d’entrée de l’appelant Fonction ProtocolClModifyCallQoSComplete . Un client utilise cette fonction pour apporter dynamiquement des modifications à la qualité de service (QoS) sur une connexion virtuelle établie ou pour négocier avec le gestionnaire d’appels pour établir la qualité de service lorsque le client configure un appel entrant.

ClCloseCallCompleteHandler

Point d’entrée de l’appelant Fonction ProtocolClCloseCallComplete .

ClAddPartyCompleteHandler

Point d’entrée de l’appelant Fonction ProtocolClAddPartyComplete . Un client utilise cette fonction pour établir des machines virtuelles de point à multipoint pour les appels sortants vers des machines distantes.

ClDropPartyCompleteHandler

Point d’entrée de l’appelant Fonction ProtocolClDropPartyComplete .

ClIncomingCallHandler

Point d’entrée de l’appelant Fonction ProtocolClIncomingCall . Un client utilise cette fonction pour accepter les appels entrants provenant de machines distantes.

ClIncomingCallQoSChangeHandler

Point d’entrée de l’appelant Fonction ProtocolClIncomingCallQoSChange . Un client utilise cette fonction pour accepter les appels entrants provenant d’ordinateurs distants sur lesquels le client d’envoi peut modifier dynamiquement la qualité de service.

ClIncomingCloseCallHandler

Point d’entrée de l’appelant Fonction ProtocolClIncomingCloseCall .

ClIncomingDropPartyHandler

Point d’entrée de l’appelant Fonction ProtocolClIncomingDropParty .

ClCallConnectedHandler

Point d’entrée de l’appelant Fonction ProtocolClCallConnected . Un client utilise cette fonction pour accepter les appels entrants provenant de machines distantes.

ClNotifyCloseAfHandler

Point d’entrée de l’appelant Fonction ProtocolClNotifyCloseAf .

Remarques

Pour spécifier des points d’entrée en tant que client CoNDIS, un pilote de protocole initialise une structure NDIS_CO_CLIENT_OPTIONAL_HANDLERS et la transmet au Fonction NdisSetOptionalHandlers .

Le client appelle NdisSetOptionalHandlers à partir de la fonction ProtocolSetOptions . Le client doit définir chaque membre ClXxx de la structure NDIS_CO_CLIENT_OPTIONAL_HANDLERS sur une fonction ProtocolXxx fournie par l’appelant, même si le gestionnaire d’appels ne prend pas en charge les appels entrants, les appels sortants ou les connexions point à multipoint. Quel que soit le sous-ensemble de fonctionnalités orientées connexion qu’un client ne prend pas en charge, ses fonctions ProtocolXxx d’espace réservé doivent retourner NDIS_STATUS_NOT_SUPPORTED.