Fungsi NdisClGetProtocolVcContextFromTapiCallId (ndis.h)

  • Artikel

NdisClGetProtocolVcContextFromTapiCallId mengambil konteks klien untuk koneksi virtual (VC) yang diidentifikasi oleh string ID Panggilan TAPI.

Sintaks

NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId(
  [in]  UNICODE_STRING TapiCallId,
  [out] PNDIS_HANDLE   ProtocolVcContext
);

Parameter

[in] TapiCallId

Untai (karakter) Unicode yang mengidentifikasi VC tertentu. String ini adalah versi Unicode dari pengidentifikasi string yang sebelumnya dikembalikan oleh fungsi NdisCoGetTapiCallID .

[out] ProtocolVcContext

Arahkan ke NDIS_HANDLE yang dialokasikan pemanggil yang menerima handel ke konteks klien untuk VC. Klien menyediakan konteks ini ke NDIS saat kembali dari handler ProtocolCoCreateVc-nya .

Nilai kembali

Mengembalikan salah satu nilai status berikut:

Menampilkan kode Deskripsi
NDIS_STATUS_SUCCESS
 NDIS berhasil mengambil handel ke konteks VC klien untuk VC yang diidentifikasi oleh string ID Panggilan TAPI.
NDIS_STATUS_FAILURE
 Upaya untuk mengambil handel ke konteks VC klien gagal.

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 pengidentifikasi string untuk VC. Klien kemudian dapat menyajikan pengidentifikasi ini sebagai string Unicode ke NdisClGetProtocolVcContextFromTapiCallId untuk mendapatkan kembali konteksnya untuk 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.

Lihat struktur UNICODE_STRING untuk informasi selengkapnya.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisClGetProtocolVcContextFromTapiCallId (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_Protocol_Driver_Function(ndis)

Lihat juga

NdisCoCreateVc

NdisCoGetTapiCallId

UNICODE_STRING