Bagikan melalui

Fungsi NdisCoGetTapiCallId (ndis.h)

  • Artikel

NdisCoGetTapiCallId mengambil string yang dapat digunakan aplikasi TAPI untuk mengidentifikasi koneksi virtual (VC) NDIS tertentu.

Sintaks

NDIS_STATUS NdisCoGetTapiCallId(
  [in]      NDIS_HANDLE NdisVcHandle,
  [in, out] PVAR_STRING TapiCallId
);

Parameter

[in] NdisVcHandle

Menentukan handel NDIS ke VC. Handel ini disediakan oleh NDIS ketika VC awalnya dibuat dengan fungsi NdisCoCreateVc .

[in, out] TapiCallId

Penunjuk ke buffer yang dialokasikan penelepon yang menerima struktur data jenis VAR_STRING. Setelah berhasil dikembalikan, struktur ini menjelaskan string yang dapat digunakan aplikasi TAPI untuk mengidentifikasi VC.

Nilai kembali

Mengembalikan salah satu nilai status berikut:

Menampilkan kode Deskripsi
NDIS_STATUS_SUCCESS
 NDIS berhasil mengembalikan pengidentifikasi string untuk VC.
NDIS_STATUS_BUFFER_TOO_SHORT
 Anggota ulTotalSize dari struktur VAR_STRING menentukan bahwa ukuran buffer tidak cukup besar untuk menahan string yang mengidentifikasi VC. NdisCoGetTapiCallId menetapkan anggota ulNeedSize dari struktur VAR_STRING ke ukuran yang diperlukan dalam byte.
NDIS_STATUS_INVALID_DATA
 Handel ke VC yang ditentukan oleh NdisVcHandle tidak valid.

Keterangan

Misalkan manajer panggilan memanggil NdisCoCreateVc untuk membuat VC untuk panggilan TAPI. NDIS pada gilirannya memasok handel ke VC ke klien. Klien meneruskan handel VC ini dalam panggilan ke fungsi NdisCoGetTapiCallId untuk mengambil string yang mengidentifikasi VC. Klien dapat meneruskan pengidentifikasi string ini ke aplikasi TAPI untuk mengidentifikasi VC.

Klien membuat konteks untuk setiap VC yang dikelolanya. Klien menggunakan NdisCoGetTapiCallId untuk mengambil pengidentifikasi string untuk setiap VC. Klien meneruskan setiap pengidentifikasi string ke aplikasi TAPI untuk mengidentifikasi setiap VC. Kemudian, jika aplikasi TAPI meneruskan salah satu pengidentifikasi string ini ke klien dalam operasi terkait VC, klien harus meneruskan pengidentifikasi string ini sebagai string Unicode dalam panggilan ke NdisClGetProtocolVcContextFromTapiCallId untuk mendapatkan kembali konteks yang benar untuk VC.

Untuk informasi selengkapnya tentang struktur VAR_STRING, lihat Objek TAPI.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisCoGetTapiCallId (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisCoGetTapiCallId (NDIS 5.1)) di Windows XP.
Target Platform Desktop
Header ndis.h (termasuk Ndis.h)
Pustaka Ndis.lib
IRQL DISPATCH_LEVEL
Aturan kepatuhan DDI Irql_Connection_Function(ndis)

Lihat juga

NdisClGetProtocolVcContextFromTapiCallId

NdisCoCreateVc