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:

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

Vedi anche

NdisCoCreateVc

NdisCoGetTapiCallId

UNICODE_STRING