Funzione NdisCoGetTapiCallId (ndis.h)

  • Articolo

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_STATUS_SUCCESS
 NDIS ha restituito correttamente un identificatore di stringa per VC.
NDIS_STATUS_BUFFER_TOO_SHORT
 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.
NDIS_STATUS_INVALID_DATA
 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)

Vedi anche

NdisClGetProtocolVcContextFromTapiCallId

NdisCoCreateVc