Condividi tramite

OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS

  • Articolo

L'OID OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS richiede un gestore chiamate o un driver MCM (Integrated Call Manager) per convertire i parametri di chiamata TAPI in parametri di chiamata NDIS. Il client che esegue una query su questo OID usa i parametri di chiamata NDIS restituiti come input (formattato come struttura di CO_CALL_PARAMETERS ) a NdisClMakeCall, con cui il client effettua una chiamata in uscita.

Questo OID usa una struttura CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, definita come segue:

typedef struct _CO_TAPI_TRANSLATE_TAPI_CALLPARAMS {
    IN  ULONG               ulLineID;
    IN  ULONG               ulAddressID;
    IN  ULONG               ulFlags;
    IN  NDIS_VAR_DATA_DESC  DestAddress;
    IN  NDIS_VAR_DATA_DESC  LineCallParams;
    OUT NDIS_VAR_DATA_DESC  NdisCallParams;
} CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, *PCO_TAPI_TRANSLATE_TAPI_CALLPARAMS;

I membri di questa struttura contengono le informazioni seguenti:

ulLineID
Specifica un identificatore di riga in base zero a cui verrà indirizzata la chiamata in uscita.

ulAddressID
Specifica un identificatore di indirizzo in base zero (nella riga specificata da ulLineID) a cui verrà indirizzata la chiamata in uscita.

ulFlags
Il client deve impostare il bit CO_TAPI_FLAG_OUTGOING_CALL in ulFlags. Il client può facoltativamente impostare il bit di CO_TAPI_USE_DEFAULT_CALLPARAMS in ulFlags per richiedere al gestore chiamate o al driver MCM di ignorare LineCallParams e restituire i parametri di chiamata NDIS predefiniti per il dispositivo.

DestAddress
Specifica una struttura NDIS_VAR_DATA_DESC che contiene un offset dall'inizio della struttura NDIS_VAR_DATA_DESC a un indirizzo di destinazione formattato come matrice di caratteri. La struttura NDIS_VAR_DATA_DESC contiene anche la lunghezza dell'indirizzo di destinazione. L'indirizzo di destinazione è l'indirizzo a cui verrà indirizzata la chiamata in uscita.

LineCallParams
Specifica una struttura NDIS_VAR_DATA_DESC che contiene un offset dall'inizio della struttura NDIS_VAR_DATA_DESC a una struttura LINE_CALL_PARAMS. La struttura NDIS_VAR_DATA_DESC contiene anche la lunghezza della struttura LINE_CALL_PARAMS. La struttura LINE_CALL_PARAMS specifica i parametri di chiamata TAPI da convertire in parametri di chiamata NDIS. Per altre informazioni sulla struttura LINE_CALL_PARAMS, vedere il Microsoft Windows SDK e il file di intestazione ndistapi.h.

NdisCallParams
Specifica una struttura NDIS_VAR_DATA_DESC che contiene un offset dall'inizio della struttura NDIS_VAR_DATA_DESC a una struttura CO_CALL_PARAMETERS. La struttura NDIS_VAR_DATA_DESC contiene anche la lunghezza della struttura CO_CALL_PARAMETERS . La struttura CO_CALL_PARAMETERS specifica i parametri di chiamata NDIS in cui sono stati convertiti i parametri di chiamata TAPI specificati.

Commenti

Se la richiesta ha esito positivo, il gestore chiamate o il driver MCM compila la struttura CO_CALL_PARAMETERS a cui fa riferimento NdisCallParams con i parametri di chiamata NDIS tradotti. Il gestore chiamate o il driver MCM devono allocare la struttura CO_CALL_PARAMETERS all'interno della sezione di memoria flat a cui fa riferimento NdisCallParams. Il client scrive la lunghezza totale della struttura CO_CALL_PARAMETERS in NdisCallParams.Length.

Se il client imposta il bit CO_TAPI_USE_DEFAULT_CALLPARAMS in ulFlags, il client non specifica i parametri di chiamata TAPI. In questo caso, il gestore chiamate o il driver MCM devono restituire i parametri di chiamata NDIS predefiniti per il dispositivo. Se non sono presenti parametri di chiamata NDIS predefiniti per il dispositivo, il gestore chiamate o il driver MCM deve restituire NDIS_STATUS_FAILURE.

Requisiti

Versione: Windows Vista e intestazione successiva: Ntddndis.h (include Ndis.h)