PROTOCOL_CL_CALL_CONNECTED função de retorno de chamada (ndis.h)

Artigo
02/29/2024

A função ProtocolClCallConnected é usada por clientes NDIS orientados a conexão que aceitam chamadas de entrada. Esses clientes devem ter funções ProtocolClCallConnected . Caso contrário, essa função ProtocolClCallConnected registrada do driver de protocolo pode simplesmente retornar o controle.

Nota Você deve declarar a função usando o tipo PROTOCOL_CL_CALL_CONNECTED . Para obter mais informações, consulte a seção Exemplos a seguir.

Sintaxe

PROTOCOL_CL_CALL_CONNECTED ProtocolClCallConnected;

void ProtocolClCallConnected(
  [in] NDIS_HANDLE ProtocolVcContext
)
{...}

Parâmetros

[in] ProtocolVcContext

Especifica o identificador do cliente para sua área de contexto por VC. O cliente originalmente retornou esse identificador para o NDIS de sua função ProtocolCoCreateVc .

Retornar valor

Nenhum

Comentários

Quando ProtocolClCallConnected é chamado, o gerenciador de chamadas concluiu com êxito o handshake final em uma oferta de chamada de entrada aceita anteriormente pela função ProtocolClIncomingCall do cliente, que já configurou os parâmetros de chamada para essa conexão em ProtocolVcContext .

A chamada para ProtocolClCallConnected indica que as transferências de dados, sejam elas de entrada ou saída, agora podem ser feitas na VC. ProtocolClCallConnected deve garantir que o cliente esteja pronto para fazer ou aceitar transferências na VC antes de retornar o controle.

Exemplos

Para definir uma função ProtocolClCallConnected , primeiro você deve fornecer uma declaração de função que identifique o tipo de função que você está definindo. O Windows fornece um conjunto de tipos de função para drivers. Declarar uma função usando os tipos de função ajuda a Análise de Código para Drivers, SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação a encontrar erros e é um requisito para escrever drivers para o sistema operacional Windows.

Por exemplo, para definir uma função ProtocolClCallConnected chamada "MyClCallConnected", use o tipo PROTOCOL_CL_CALL_CONNECTED conforme mostrado neste exemplo de código:

PROTOCOL_CL_CALL_CONNECTED MyClCallConnected;

Em seguida, implemente sua função da seguinte maneira:

_Use_decl_annotations_
VOID
 MyClCallConnected(
    NDIS_HANDLE  ProtocolVcContext
    )
  {...}

O tipo de função PROTOCOL_CL_CALL_CONNECTED é definido no arquivo de cabeçalho Ndis.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação Use_decl_annotations à sua definição de função. A anotação Use_decl_annotations garante que as anotações aplicadas ao tipo de função PROTOCOL_CL_CALL_CONNECTED no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers NDIS.

Para obter informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte ProtocolClCallConnected (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte ProtocolClCallConnected (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Windows
Cabeçalho	ndis.h (inclua Ndis.h)
IRQL	<= DISPATCH_LEVEL