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 oggetto VC specifico. 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 al contesto client per il vco. Il client ha fornito questo contesto a NDIS al 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. |
|
Tentativo di recuperare l'handle nel contesto vc client non riuscito. |
Osservazioni
Si supponga che un gestore chiamate NdisCoCreateVc per creare un VC per una chiamata TAPI. NDIS fornisce a sua volta l'handle al vc a un client. Il client passa questo handle VC in una chiamata al NdisCoGetTapiCallId funzione per recuperare un identificatore di stringa per vc. Il client può quindi presentare questo identificatore come stringa Unicode per NdisClGetProtocolVcContextFromTapiCallId per recuperare il contesto per vc.
Il client crea un contesto per ogni vc gestito. Il client usa NdisCoGetTapiCallId per recuperare un identificatore di stringa per ogni vco. Il client passa ogni identificatore di stringa a un'applicazione TAPI per identificare ogni vco. 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 di stringa come stringa Unicode in una chiamata a NdisClGetProtocolVcContextFromTapiCallId per recuperare il contesto corretto per vc.
Per altre informazioni, vedere la struttura UNICODE_STRING.
Fabbisogno
| 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 (include Ndis.h) |
| libreria | Ndis.lib |
| IRQL | DISPATCH_LEVEL |
| regole di conformità DDI | Irql_Protocol_Driver_Function (ndis) |