Função NdisClGetProtocolVcContextFromTapiCallId (ndis.h)

NdisClGetProtocolVcContextFromTapiCallId recupera o contexto do cliente para uma VC (conexão virtual) identificada por uma cadeia de caracteres de ID de Chamada TAPI.

Sintaxe

NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId(
  [in]  UNICODE_STRING TapiCallId,
  [out] PNDIS_HANDLE   ProtocolVcContext
);

Parâmetros

[in] TapiCallId

Cadeia de caracteres Unicode que identifica uma VC específica. Essa cadeia de caracteres é a versão Unicode de um identificador de cadeia de caracteres que foi retornado anteriormente pela função NdisCoGetTapiCallID .

[out] ProtocolVcContext

Ponteiro para um NDIS_HANDLE alocado pelo chamador que recebe um identificador para o contexto do cliente para a VC. O cliente forneceu esse contexto ao NDIS no retorno de seu manipulador ProtocolCoCreateVc .

Retornar valor

Retorna um dos seguintes valores de status:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	O NDIS recuperou com êxito o identificador para o contexto de VC do cliente para a VC identificada pela cadeia de caracteres de ID de Chamada TAPI.
NDIS_STATUS_FAILURE	Falha na tentativa de recuperar o identificador para o contexto de VC do cliente.

Comentários

Suponha que um gerenciador de chamadas chame NdisCoCreateVc para criar uma VC para uma chamada TAPI. O NDIS, por sua vez, fornece o identificador para a VC para um cliente. O cliente passa esse identificador de VC em uma chamada para a função NdisCoGetTapiCallId para recuperar um identificador de cadeia de caracteres para a VC. Em seguida, o cliente pode apresentar esse identificador como uma cadeia de caracteres Unicode para NdisClGetProtocolVcContextFromTapiCallId para recuperar seu contexto para a VC.

O cliente cria um contexto para cada VC que gerencia. O cliente usa NdisCoGetTapiCallId para recuperar um identificador de cadeia de caracteres para cada VC. O cliente passa cada identificador de cadeia de caracteres para um aplicativo TAPI para identificar cada VC. Posteriormente, se um aplicativo TAPI passar um desses identificadores de cadeia de caracteres para o cliente em uma operação relacionada à VC, o cliente deverá passar esse identificador de cadeia de caracteres como uma cadeia de caracteres Unicode em uma chamada para NdisClGetProtocolVcContextFromTapiCallId para obter de volta o contexto correto para a VC.

Consulte a estrutura UNICODE_STRING para obter mais informações.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	DISPATCH_LEVEL
Regras de conformidade de DDI	Irql_Protocol_Driver_Function(ndis)

Confira também

NdisCoCreateVc

NdisCoGetTapiCallId

UNICODE_STRING