struttura NDIS_CO_CLIENT_OPTIONAL_HANDLERS (ndis.h)

Articolo
02/29/2024

La struttura NDIS_CO_CLIENT_OPTIONAL_HANDLERS specifica i punti di ingresso per le funzioni ProtocolXxx del client CoNDIS per il driver di protocollo che passa questa struttura all'oggetto Funzione NdisSetOptionalHandlers .

Sintassi

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;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura delle caratteristiche coNDIS del driver di protocollo (NDIS_CO_CLIENT_OPTIONAL_HANDLERS). Il driver imposta il
Membro di tipo della struttura specificata da Header per NDIS_OBJECT_TYPE_CO_CLIENT_OPTIONAL_HANDLERS, membro Revision da NDIS_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1 e membro Size da NDIS_SIZEOF_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1.

Reserved

Riservato per NDIS.

ClCreateVcHandler

Punto di ingresso della funzione ProtocolCoCreateVc del chiamante.

ClDeleteVcHandler

Punto di ingresso della funzione ProtocolCoDeleteVc del chiamante.

ClOidRequestHandler

Punto di ingresso del chiamante Funzione ProtocolCoOidRequest .

ClOidRequestCompleteHandler

Punto di ingresso del chiamante Funzione ProtocolCoOidRequestComplete .

ClOpenAfCompleteHandlerEx

Punto di ingresso del chiamante Funzione ProtocolClOpenAfCompleteEx .

ClCloseAfCompleteHandler

Punto di ingresso del chiamante Funzione ProtocolClCloseAfComplete .

ClRegisterSapCompleteHandler

Punto di ingresso del chiamante Funzione ProtocolClRegisterSapComplete . Un client usa questa funzione per accettare le chiamate in ingresso dai computer remoti.

ClDeregisterSapCompleteHandler

Punto di ingresso del chiamante Funzione ProtocolClDeregisterSapComplete .

ClMakeCallCompleteHandler

Punto di ingresso del chiamante Funzione ProtocolClMakeCallComplete . Un client usa questa funzione per effettuare chiamate in uscita ai computer remoti.

ClModifyCallQoSCompleteHandler

Punto di ingresso del chiamante Funzione ProtocolClModifyCallQoSComplete . Un client usa questa funzione per apportare in modo dinamico modifiche alla qualità del servizio (QoS) in una connessione virtuale stabilita (VC) o per negoziare con il gestore chiamate per stabilire il QoS quando il client configura una chiamata in ingresso.

ClCloseCallCompleteHandler

Punto di ingresso del chiamante Funzione ProtocolClCloseCallComplete .

ClAddPartyCompleteHandler

Punto di ingresso del chiamante Funzione ProtocolClAddPartyComplete . Un client usa questa funzione per stabilire schede virtuali da punto a più punti per le chiamate in uscita ai computer remoti.

ClDropPartyCompleteHandler

Punto di ingresso del chiamante Funzione ProtocolClDropPartyComplete .

ClIncomingCallHandler

Punto di ingresso del chiamante Funzione ProtocolClIncomingCall . Un client usa questa funzione per accettare le chiamate in ingresso dai computer remoti.

ClIncomingCallQoSChangeHandler

Punto di ingresso del chiamante Funzione ProtocolClIncomingCallQoSChange . Un client usa questa funzione per accettare chiamate in ingresso da computer remoti in cui il client di invio può modificare dinamicamente il QoS.

ClIncomingCloseCallHandler

Punto di ingresso del chiamante Funzione ProtocolClIncomingCloseCall .

ClIncomingDropPartyHandler

Punto di ingresso del chiamante Funzione ProtocolClIncomingDropParty .

ClCallConnectedHandler

Punto di ingresso del chiamante Funzione ProtocolClCallConnected . Un client usa questa funzione per accettare le chiamate in ingresso dai computer remoti.

ClNotifyCloseAfHandler

Punto di ingresso del chiamante Funzione ProtocolClNotifyCloseAf .

Commenti

Per specificare i punti di ingresso come client CoNDIS, un driver di protocollo inizializza una struttura NDIS_CO_CLIENT_OPTIONAL_HANDLERS e lo passa all'oggetto Funzione NdisSetOptionalHandlers .

Il client chiama NdisSetOptionalHandlers dalla funzione ProtocolSetOptions . Il client deve impostare ogni membro ClXxx nella struttura NDIS_CO_CLIENT_OPTIONAL_HANDLERS su una funzione ProtocolXxx fornita dal chiamante, anche se il gestore chiamate in ingresso, le chiamate in uscita o le connessioni da punto a punto non sono supportate. Per qualsiasi subset di funzionalità orientate alla connessione non supportate da un client, le funzioni ProtocolXxx segnaposto devono restituire NDIS_STATUS_NOT_SUPPORTED.