Condividi tramite


Funzione NdisClGetProtocolVcContextFromTapiCallId (ndis.h)

NdisClGetProtocolVcContextFromTapiCallId recupera il contesto client per una connessione virtuale identificata da una stringa ID chiamata TAPI.

Sintassi

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

Parametri

[in] TapiCallId

Stringa Unicode che identifica un determinato VC. Questa stringa è la versione Unicode di un identificatore di stringa restituito in precedenza dalla funzione NdisCoGetTapiCallID .

[out] ProtocolVcContext

Puntatore a un NDIS_HANDLE allocato dal chiamante che riceve un handle nel contesto client per il VC. Il client ha fornito questo contesto a NDIS sul ritorno dal relativo gestore ProtocolCoCreateVc .

Valore restituito

Restituisce uno dei valori di stato seguenti:

Codice restituito Descrizione
NDIS_STATUS_SUCCESS
NDIS ha recuperato correttamente l'handle nel contesto VC client per il VC identificato dalla stringa ID chiamata TAPI.
NDIS_STATUS_FAILURE
Il tentativo di recuperare l'handle nel contesto VC client non è riuscito.

Commenti

Si supponga che un gestore chiamate NdisCoCreateVc per creare un VC per una chiamata TAPI. NDIS a sua volta fornisce l'handle al VC a un client. Il client passa questo handle VC in una chiamata alla funzione NdisCoGetTapiCallId per recuperare un identificatore di stringa per il VC. Il client può quindi presentare questo identificatore come stringa Unicode a NdisClGetProtocolVcContextFromTapiCallId per tornare al contesto per IL VC.

Il client crea un contesto per ogni VC gestito. Il client usa NdisCoGetTapiCallId per recuperare un identificatore di stringa per ogni VC. Il client passa ogni identificatore di stringa a un'applicazione TAPI per identificare ogni VC. In seguito, se un'applicazione TAPI passa uno di questi identificatori di stringa al client in un'operazione correlata a VC, il client deve passare questo identificatore stringa come stringa Unicode in una chiamata a NdisClGetProtocolVcContextFromTapiCallId per tornare al contesto corretto per il VC.

Per altre informazioni, vedere la struttura UNICODE_STRING .

Requisiti

Requisito Valore
Client minimo supportato Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1) in Windows XP.
Piattaforma di destinazione Desktop
Intestazione ndis.h (includere Ndis.h)
Libreria Ndis.lib
IRQL DISPATCH_LEVEL
Regole di conformità DDI Irql_Protocol_Driver_Function(ndis)

Vedi anche

NdisCoCreateVc

NdisCoGetTapiCallId

UNICODE_STRING