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 ha recuperato correttamente l'handle nel contesto VC client per il VC identificato dalla stringa ID chiamata TAPI. |
|
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) |