estructura NDIS_CO_CLIENT_OPTIONAL_HANDLERS (ndis.h)

Artículo
02/29/2024

La estructura NDIS_CO_CLIENT_OPTIONAL_HANDLERS especifica los puntos de entrada para las funciones ProtocolXxx de cliente coNDIS para el controlador de protocolo que pasa esta estructura a la Función NdisSetOptionalHandlers .

Sintaxis

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;

Miembros

Header

Estructura de NDIS_OBJECT_HEADER para la estructura de características coNDIS del controlador de protocolo (NDIS_CO_CLIENT_OPTIONAL_HANDLERS). El controlador establece el
Miembro de tipo de la estructura que Header especifica para NDIS_OBJECT_TYPE_CO_CLIENT_OPTIONAL_HANDLERS, el miembro Revision que se va a NDIS_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1 y el miembro Size que se va a NDIS_SIZEOF_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1.

Reserved

Reservado para NDIS.

ClCreateVcHandler

Punto de entrada de la función ProtocolCoCreateVc del autor de la llamada.

ClDeleteVcHandler

Punto de entrada de la función ProtocolCoDeleteVc del autor de la llamada.

ClOidRequestHandler

Punto de entrada del autor de la llamada Función ProtocolCoOidRequest .

ClOidRequestCompleteHandler

Punto de entrada del autor de la llamada Función ProtocolCoOidRequestComplete .

ClOpenAfCompleteHandlerEx

Punto de entrada del autor de la llamada Función ProtocolClOpenAfCompleteEx .

ClCloseAfCompleteHandler

Punto de entrada del autor de la llamada Función ProtocolClCloseAfComplete .

ClRegisterSapCompleteHandler

Punto de entrada del autor de la llamada Función ProtocolClRegisterSapComplete . Un cliente usa esta función para aceptar llamadas entrantes desde máquinas remotas.

ClDeregisterSapCompleteHandler

Punto de entrada del autor de la llamada Función ProtocolClDeregisterSapComplete .

ClMakeCallCompleteHandler

Punto de entrada del autor de la llamada Función ProtocolClMakeCallComplete . Un cliente usa esta función para realizar llamadas salientes a máquinas remotas.

ClModifyCallQoSCompleteHandler

Punto de entrada del autor de la llamada Función ProtocolClModifyCallQoSComplete . Un cliente usa esta función para realizar cambios dinámicos en la calidad de servicio (QoS) en una conexión virtual establecida (VC) o para negociar con el administrador de llamadas para establecer el QoS cuando el cliente configura una llamada entrante.

ClCloseCallCompleteHandler

Punto de entrada del autor de la llamada Función ProtocolClCloseCallComplete .

ClAddPartyCompleteHandler

Punto de entrada del autor de la llamada Función ProtocolClAddPartyComplete . Un cliente usa esta función para establecer máquinas virtuales de punto a punto para llamadas salientes a máquinas remotas.

ClDropPartyCompleteHandler

Punto de entrada del autor de la llamada Función ProtocolClDropPartyComplete .

ClIncomingCallHandler

Punto de entrada del autor de la llamada Función ProtocolClIncomingCall . Un cliente usa esta función para aceptar llamadas entrantes desde máquinas remotas.

ClIncomingCallQoSChangeHandler

Punto de entrada del autor de la llamada Función ProtocolClIncomingCallQoSChange . Un cliente usa esta función para aceptar llamadas entrantes desde máquinas remotas en las que el cliente de envío puede cambiar dinámicamente el QoS.

ClIncomingCloseCallHandler

Punto de entrada del autor de la llamada Función ProtocolClIncomingCloseCall .

ClIncomingDropPartyHandler

Punto de entrada del autor de la llamada Función ProtocolClIncomingDropParty .

ClCallConnectedHandler

Punto de entrada del autor de la llamada Función ProtocolClCallConnected . Un cliente usa esta función para aceptar llamadas entrantes desde máquinas remotas.

ClNotifyCloseAfHandler

Punto de entrada del autor de la llamada Función ProtocolClNotifyCloseAf .

Comentarios

Para especificar puntos de entrada como un cliente de CoNDIS, un controlador de protocolo inicializa una estructura de NDIS_CO_CLIENT_OPTIONAL_HANDLERS y la pasa a la Función NdisSetOptionalHandlers .

El cliente llama a NdisSetOptionalHandlers desde la función ProtocolSetOptions . El cliente debe establecer todos los miembros ClXxx de la estructura NDIS_CO_CLIENT_OPTIONAL_HANDLERS en una función ProtocolXxx proporcionada por el autor de la llamada, incluso si el administrador de llamadas no admite llamadas entrantes, llamadas salientes o conexiones de punto a varios puntos. Para cualquier subconjunto de funcionalidad orientada a la conexión que un cliente no admita, sus funciones ProtocolXxx de marcador de posición deben devolver NDIS_STATUS_NOT_SUPPORTED.