Fungsi NdisClRegisterSap (ndis.h)

Artikel
08/07/2023

NdisClRegisterSap mendaftarkan SAP tempat klien dapat menerima panggilan masuk dari simpul jarak jauh.

Sintaks

NDIS_STATUS NdisClRegisterSap(
  [in]  NDIS_HANDLE  NdisAfHandle,
  [in]  NDIS_HANDLE  ProtocolSapContext,
  [in]  PCO_SAP      Sap,
  [out] PNDIS_HANDLE NdisSapHandle
);

Parameter

[in] NdisAfHandle

Menentukan handel yang dikembalikan oleh NdisClOpenAddressFamilyEx, yang secara implisit mengidentifikasi manajer panggilan untuk mendaftarkan SAP.

[in] ProtocolSapContext

Menentukan handel ke area konteks penduduk yang disediakan penelepon tempat klien mempertahankan status untuk SAP ini setelah dibuka. NDIS meneruskan handel ini kembali ke klien dalam semua panggilan berikutnya mengenai SAP ini jika panggilan ke NdisClRegisterSap berhasil.

[in] Sap

Penunjuk ke spesifikasi yang disediakan klien agar SAP dibuka, diformat sebagai struktur jenis CO_SAP.

[out] NdisSapHandle

Penunjuk ke variabel di mana handel ke SAP yang baru terdaftar dikembalikan jika panggilan ini berhasil.

Nilai kembali

Ketika NdisClRegisterSap mengembalikan apa pun selain NDIS_STATUS_PENDING, klien harus melakukan panggilan internal ke Fungsi ProtocolClRegisterSapComplete . Jika tidak, NDIS memanggil fungsi ProtocolClRegisterSapComplete klien ketika operasi ini selesai.

Keterangan

Dengan panggilan ke NdisClRegisterSap, klien meminta pemberitahuan panggilan masuk pada SAP tertentu. NDIS meneruskan informasi SAP yang diberikan ke fungsi ProtocolCmRegisterSap manajer panggilan untuk validasi. Jika SAP yang diberikan sudah digunakan atau jika manajer panggilan tidak mengenali spesifikasi yang disediakan klien di Sap, manajer panggilan akan gagal dalam permintaan ini.

Format SAP tergantung sedang dan khusus untuk keluarga alamat yang didukung oleh manajer panggilan, yang menggunakan SAP terdaftar kemudian untuk merutekan panggilan masuk ke klien yang sesuai. Manajer panggilan dapat mendaftarkan SAP untuk PVC yang ditetapkan tanpa menghubungi komponen jaringan lain, tergantung pada media yang mendasar.

Jika panggilannya ke NdisClRegisterSap berhasil, klien harus menyimpan handel yang dikembalikan di NdisSapHandle karena merupakan parameter yang diperlukan untuk NdisClDeregisterSap. Penelepon NdisClRegisterSap biasanya meneruskan penunjuk ke variabel di area status yang dialokasikan klien di ProtocolSapContext sehingga NDIS dapat mengaturnya ke NdisSapHandle jika panggilan ini berhasil. NDIS meneruskan ProtocolSapContext yang diberikan ke fungsi ProtocolCl/CoXxx terdaftar klien di semua panggilan berikutnya mengenai SAP ini sampai klien memanggil NdisClDeregisterSap.

Biasanya, klien memanggil NdisClRegisterSap dari fungsi ProtocolAfRegisterNotify setelah panggilannya yang berhasil ke NdisClOpenAddressFamilyEx. Mendaftarkan satu atau beberapa SAP memungkinkan klien untuk menerima panggilan masuk segera setelah manajer panggilan menerimanya melalui jaringan.

Berbeda dengan panggilan keluar yang dimulai klien, klien tidak memanggil NdisCoCreateVc sebelum memanggil NdisClRegisterSap. Untuk panggilan masuk, manajer panggilan memulai pembuatan VC, sebagai berikut:

Pada penerimaan panggilan masuk pada SAP terdaftar, manajer panggilan pertama-tama memanggil NdisCoCreateVc, menyebabkan NDIS memanggil fungsi ProtocolCoCreateVc klien.
Ketika VC telah disiapkan dan diaktifkan, manajer panggilan memanggil NdisCmDispatchIncomingCall, menyebabkan NDIS memanggil klien Fungsi ProtocolClIncomingCall .

Persyaratan

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