OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS

OID OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS meminta manajer panggilan atau driver miniport manajer panggilan terintegrasi (MCM) untuk menerjemahkan parameter panggilan TAPI ke parameter panggilan NDIS. Klien yang meminta OID ini menggunakan parameter panggilan NDIS yang dikembalikan sebagai input (diformat sebagai struktur CO_CALL_PARAMETERS ) ke NdisClMakeCall, yang dengannya klien melakukan panggilan keluar.

OID ini menggunakan struktur CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, yang didefinisikan sebagai berikut:

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;

Anggota struktur ini berisi informasi berikut:

ulLineID
Menentukan pengidentifikasi baris berbasis nol tempat panggilan keluar akan diarahkan.

ulAddressID
Menentukan pengidentifikasi alamat berbasis nol (pada baris yang ditentukan oleh ulLineID) tempat panggilan keluar akan diarahkan.

ulFlags
Klien harus mengatur bit CO_TAPI_FLAG_OUTGOING_CALL di ulFlags. Klien dapat secara opsional mengatur bit CO_TAPI_USE_DEFAULT_CALLPARAMS di ulFlags untuk mengharuskan manajer panggilan atau driver MCM untuk mengabaikan LineCallParams dan mengembalikan parameter panggilan NDIS default untuk perangkat.

DestAddress
Menentukan struktur NDIS_VAR_DATA_DESC yang berisi offset dari awal struktur NDIS_VAR_DATA_DESC ke alamat tujuan yang diformat sebagai array karakter. Struktur NDIS_VAR_DATA_DESC juga berisi panjang alamat tujuan. Alamat tujuan adalah alamat tempat panggilan keluar akan diarahkan.

LineCallParams
Menentukan struktur NDIS_VAR_DATA_DESC yang berisi offset dari awal struktur NDIS_VAR_DATA_DESC ke struktur LINE_CALL_PARAMS. Struktur NDIS_VAR_DATA_DESC juga berisi panjang struktur LINE_CALL_PARAMS. Struktur LINE_CALL_PARAMS menentukan parameter panggilan TAPI yang akan diterjemahkan ke dalam parameter panggilan NDIS. Untuk informasi selengkapnya tentang struktur LINE_CALL_PARAMS, lihat Microsoft Windows SDK dan file header ndistapi.h.

NdisCallParams
Menentukan struktur NDIS_VAR_DATA_DESC yang berisi offset dari awal struktur NDIS_VAR_DATA_DESC ke struktur CO_CALL_PARAMETERS. Struktur NDIS_VAR_DATA_DESC juga berisi panjang struktur CO_CALL_PARAMETERS . Struktur CO_CALL_PARAMETERS menentukan parameter panggilan NDIS tempat parameter panggilan TAPI yang diberikan telah diterjemahkan.

Keterangan

Jika permintaan berhasil, manajer panggilan atau driver MCM mengisi struktur CO_CALL_PARAMETERS yang direferensikan oleh NdisCallParams dengan parameter panggilan NDIS yang diterjemahkan. Manajer panggilan atau driver MCM harus mengalokasikan struktur CO_CALL_PARAMETERS dalam bagian memori datar yang disebut oleh NdisCallParams. Klien menulis panjang total struktur CO_CALL_PARAMETERS ke NdisCallParams.Length.

Jika klien mengatur bit CO_TAPI_USE_DEFAULT_CALLPARAMS di ulFlags, klien tidak menentukan parameter panggilan TAPI. Dalam hal ini, manajer panggilan atau driver MCM harus mengembalikan parameter panggilan NDIS default untuk perangkat. Jika tidak ada parameter panggilan NDIS default untuk perangkat, manajer panggilan atau driver MCM harus mengembalikan NDIS_STATUS_FAILURE.

Persyaratan

Versi: Windows Vista dan Header yang lebih baru: Ntddndis.h (sertakan Ndis.h)