Makro NdisMCmRegisterSapComplete (ndis.h)

Artikel
03/08/2023

NdisMCmRegisterSapComplete mengembalikan status akhir permintaan klien, tempat driver MCM

Fungsi ProtocolCmRegisterSap sebelumnya mengembalikan NDIS_STATUS_PENDING, untuk mendaftarkan SAP.

Sintaks

void NdisMCmRegisterSapComplete(
   _S_,
   _H_,
   _C_
);

Parameter

_S_

Menentukan status akhir untuk permintaan asli klien untuk mendaftarkan SAP, baik NDIS_STATUS_SUCCESS atau penelepon apa pun yang ditentukan NDIS_STATUS_XXXkecuali NDIS_STATUS_PENDING.

_H_

Menentukan handel yang disediakan NDIS ke SAP jika pendaftaran berhasil. Manajer panggilan memperoleh handel ini sebagai parameter input ke fungsi ProtocolCmRegisterSap-nya .

_C_

Menentukan handel ke area konteks penduduk yang disediakan penelepon di mana driver MCM mempertahankan status untuk SAP ini jika pendaftaran berhasil. Jika demikian, NDIS meneruskan handel ini kembali ke driver MCM di semua panggilan berikutnya mengenai SAP ini. Jika Status diatur ke sesuatu selain NDIS_STATUS_SUCCESS, NDIS mengabaikan parameter ini.

Nilai kembali

Tidak ada

Keterangan

Driver MCM harus memanggil NdisMCmRegisterSapComplete jika fungsi ProtocolCmRegisterSap-nya mengembalikan NDIS_STATUS_PENDING ketika dipanggil dengan NdisSapHandle yang diberikan. Panggilan ke NdisMCmRegisterSapComplete menyebabkan NDIS memanggil klien Fungsi ProtocolClRegisterSapComplete .

Jika driver MCM menetapkan Status ke apa pun selain NDIS_STATUS_SUCCESS, driver tersebut harus menganggap NdisSapHandle tidak valid ketika NdisMCmRegisterSapComplete mengembalikan kontrol. Setelah gagal dalam pendaftaran SAP, CM dapat merilis atau menggunakan kembali area konteks per-SAP, jika ada, yang sudah dialokasikan. NDIS juga merilis konteksnya untuk SAP jika driver MCM gagal pendaftaran.

Hanya driver miniport berorientasi koneksi yang menyediakan dukungan manajemen panggilan terintegrasi yang dapat memanggil NdisMCmRegisterSapComplete. Manajer panggilan yang berdiri sendiri, yang mendaftarkan diri dengan NDIS sebagai driver protokol, panggil NdisCmRegisterSapComplete sebagai gantinya.

Persyaratan

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