estrutura NDIS_CO_CLIENT_OPTIONAL_HANDLERS (ndis.h)

Artigo
08/07/2023

A estrutura NDIS_CO_CLIENT_OPTIONAL_HANDLERS especifica pontos de entrada para funções ProtocolXxx do cliente CoNDIS para o driver de protocolo que passa essa estrutura para o Função NdisSetOptionalHandlers .

Sintaxe

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;

Membros

Header

A estrutura de NDIS_OBJECT_HEADER para a estrutura de características coNDIS do driver de protocolo (NDIS_CO_CLIENT_OPTIONAL_HANDLERS). O driver define o
Membro do tipo da estrutura especificada pelo Cabeçalho para NDIS_OBJECT_TYPE_CO_CLIENT_OPTIONAL_HANDLERS, o membro Revision a NDIS_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1 e o membro Size a ser NDIS_SIZEOF_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1.

Reserved

Reservado para NDIS.

ClCreateVcHandler

O ponto de entrada da função ProtocolCoCreateVc do chamador.

ClDeleteVcHandler

O ponto de entrada da função ProtocolCoDeleteVc do chamador.

ClOidRequestHandler

O ponto de entrada do chamador Função ProtocolCoOidRequest .

ClOidRequestCompleteHandler

O ponto de entrada do chamador Função ProtocolCoOidRequestComplete .

ClOpenAfCompleteHandlerEx

O ponto de entrada do chamador Função ProtocolClOpenAfCompleteEx .

ClCloseAfCompleteHandler

O ponto de entrada do chamador Função ProtocolClCloseAfComplete .

ClRegisterSapCompleteHandler

O ponto de entrada do chamador Função ProtocolClRegisterSapComplete . Um cliente usa essa função para aceitar chamadas de entrada de computadores remotos.

ClDeregisterSapCompleteHandler

O ponto de entrada do chamador Função ProtocolClDeregisterSapComplete .

ClMakeCallCompleteHandler

O ponto de entrada do chamador Função ProtocolClMakeCallComplete . Um cliente usa essa função para fazer chamadas de saída para computadores remotos.

ClModifyCallQoSCompleteHandler

O ponto de entrada do chamador Função ProtocolClModifyCallQoSComplete . Um cliente usa essa função para fazer alterações dinamicamente na QoS (qualidade de serviço) em uma VC (conexão virtual) estabelecida ou para negociar com o gerenciador de chamadas para estabelecer a QoS quando o cliente configurar uma chamada de entrada.

ClCloseCallCompleteHandler

O ponto de entrada do chamador Função ProtocolClCloseCallComplete .

ClAddPartyCompleteHandler

O ponto de entrada do chamador Função ProtocolClAddPartyComplete . Um cliente usa essa função para estabelecer VCs ponto a multiponto para chamadas de saída para computadores remotos.

ClDropPartyCompleteHandler

O ponto de entrada do chamador Função ProtocolClDropPartyComplete .

ClIncomingCallHandler

O ponto de entrada do chamador Função ProtocolClIncomingCall . Um cliente usa essa função para aceitar chamadas de entrada de computadores remotos.

ClIncomingCallQoSChangeHandler

O ponto de entrada do chamador Função ProtocolClIncomingCallQoSChange . Um cliente usa essa função para aceitar chamadas de entrada de computadores remotos nos quais o cliente de envio pode alterar dinamicamente a QoS.

ClIncomingCloseCallHandler

O ponto de entrada do chamador Função ProtocolClIncomingCloseCall .

ClIncomingDropPartyHandler

O ponto de entrada do chamador Função ProtocolClIncomingDropParty .

ClCallConnectedHandler

O ponto de entrada do chamador Função ProtocolClCallConnected . Um cliente usa essa função para aceitar chamadas de entrada de computadores remotos.

ClNotifyCloseAfHandler

O ponto de entrada do chamador Função ProtocolClNotifyCloseAf .

Comentários

Para especificar pontos de entrada como um cliente CoNDIS, um driver de protocolo inicializa uma estrutura NDIS_CO_CLIENT_OPTIONAL_HANDLERS e a passa para o Função NdisSetOptionalHandlers .

O cliente chama NdisSetOptionalHandlers da função ProtocolSetOptions . O cliente deve definir cada membro ClXxx na estrutura NDIS_CO_CLIENT_OPTIONAL_HANDLERS para uma função ProtocolXxx fornecida pelo chamador, mesmo que o gerenciador de chamadas não dê suporte a chamadas de entrada, chamadas de saída ou conexões ponto a multipoint. Para qualquer subconjunto de funcionalidade orientada à conexão à qual um cliente não dá suporte, suas funções ProtocolXxx de espaço reservado devem retornar NDIS_STATUS_NOT_SUPPORTED.