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 |
|---|---|
|
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. |
|
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) |