Fungsi NdisClIncomingCallComplete (ndis.h)

Artikel
08/07/2023

NdisClIncomingCallComplete mengembalikan penerimaan atau penolakan klien atas panggilan masuk yang ditawarkan, yang fungsi ProtocolClIncomingCall klien sebelumnya dikembalikan NDIS_STATUS_PENDING.

Sintaks

void NdisClIncomingCallComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parameter

[in] Status

Diatur ke NDIS_STATUS_SUCCESS jika klien menerima panggilan yang ditawarkan. Jika tidak, parameter ini dapat diatur ke NDIS_STATUS_XXX kecuali NDIS_STATUS_PENDING untuk menunjukkan alasan yang ditentukan klien untuk menolak panggilan.

[in] NdisVcHandle

Menentukan handel ke VC yang dibuat oleh pengelola panggilan untuk mewakili panggilan masuk. Klien memperoleh handel ini dari status per VC yang ditunjuk oleh ProtocolVcContext yang diteruskan sebagai parameter input ke Fungsi ProtocolClIncomingCall .

[in] CallParameters

Penunjuk ke struktur jenis CO_CALL_PARAMETERS, menentukan parameter panggilan untuk panggilan masuk.

Nilai kembali

Tidak ada

Keterangan

Jika fungsi ProtocolClIncomingCall klien mengembalikan NDIS_STATUS_PENDING untuk panggilan yang ditawarkan yang masuk pada SAP tertentu, yang sebelumnya didaftarkan oleh klien dengan NdisClRegisterSap, klien kemudian harus memanggil NdisClIncomingCallComplete untuk menunjukkan apakah klien menerima atau menolak panggilan yang ditawarkan.

Sebelum memanggil NdisClIncomingCallComplete, klien tersebut dapat bernegosiasi dengan manajer panggilan dengan memanggil NdisClModifyCallQoS satu atau beberapa kali sampai kedua driver mencapai perjanjian tentang kualitas layanan yang dapat diterima untuk panggilan masuk atau klien menentukan bahwa ia harus menolak panggilan yang ditawarkan karena upayanya untuk memodifikasi QoS mencapai beberapa batas yang ditentukan klien tanpa menghasilkan perjanjian.

Jika klien telah mengubah parameter panggilan yang diteruskan ke fungsi ProtocolClIncomingCall-nya , klien harus mengatur anggota Bendera dalam struktur CO_CALL_PARAMETERS dengan CALL_PARAMETERS_CHANGED ketika meneruskan perubahan ini ke NdisClIncomingCallComplete. Bergantung pada apakah manajer panggilan menerima atau menolak perubahan yang diusulkan klien pada parameter panggilan, NDIS kemudian memanggil salah satu klien Fungsi ProtocolClCallConnected atau fungsinya ProtocolClIncomingCloseCall masing-masing.

Panggilan ke NdisClIncomingCallComplete menyebabkan NDIS memanggil CM Fungsi ProtocolCmIncomingCallComplete . NDIS meneruskan parameter NdisClIncomingCallComplete yang disediakan klien sebagai parameter input ke ProtocolCmIncomingCallComplete.

Jika klien menolak panggilan yang ditawarkan dengan mengatur Status ke sesuatu selain NDIS_STATUS_SUCCESS, klien harus menganggap penunjuk CallParameters tidak valid segera setelah panggilannya ke NdisClIncomingCallComplete terjadi.

Persyaratan

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