Funzione NdisCoGetTapiCallId (ndis.h)
NdisCoGetTapiCallId recupera una stringa che le applicazioni TAPI possono usare per identificare una determinata connessione virtuale NDIS (VC).
Sintassi
NDIS_STATUS NdisCoGetTapiCallId(
[in] NDIS_HANDLE NdisVcHandle,
[in, out] PVAR_STRING TapiCallId
);
Parametri
[in] NdisVcHandle
Specifica l'handle NDIS nel VC. Questo handle è stato fornito da NDIS quando il VC è stato originariamente creato con la funzione NdisCoCreateVc .
[in, out] TapiCallId
Puntatore a un buffer allocato dal chiamante che riceve una struttura di dati di tipo VAR_STRING. Al termine della restituzione, questa struttura descrive una stringa che le applicazioni TAPI possono usare per identificare il VC.
Valore restituito
Restituisce uno dei valori di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
|
NDIS ha restituito correttamente un identificatore di stringa per VC. |
|
Il membro ulTotalSize della struttura VAR_STRING specifica che le dimensioni del buffer non sono sufficienti per contenere la stringa che identifica il VC. NdisCoGetTapiCallId imposta il membro ulNeededSize della struttura VAR_STRING alle dimensioni necessarie in byte. |
|
L'handle del vc specificato da NdisVcHandle non è valido. |
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 una stringa che identifica il VC. Il client può passare questo identificatore di stringa a un'applicazione TAPI per identificare 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 di stringa come stringa Unicode in una chiamata a NdisClGetProtocolVcContextFromTapiCallId per tornare al contesto corretto per vco.
Per altre informazioni sulla struttura VAR_STRING, vedere Oggetti TAPI.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisCoGetTapiCallId (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisCoGetTapiCallId (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_Connection_Function(ndis) |