Fungsi NdisCmRegisterSapComplete (ndis.h)

  • Artikel

NdisCmRegisterSapComplete mengembalikan status akhir permintaan klien, di mana CM sebelumnya mengembalikan NDIS_STATUS_PENDING, untuk mendaftarkan SAP.

Sintaks

void NdisCmRegisterSapComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisSapHandle,
  [in] NDIS_HANDLE CallMgrSapContext
);

Parameter

[in] Status

Menentukan status akhir permintaan asli klien untuk mendaftarkan SAP, baik NDIS_STATUS_SUCCESS atau NDIS_STATUS_XXXX yang ditentukan CM kecuali NDIS_STATUS_PENDING.

[in] NdisSapHandle

Menentukan handel yang disediakan NDIS ke SAP jika pendaftaran berhasil. Manajer panggilan memperoleh handel ini sebagai parameter input untuk Fungsi ProtocolCmRegisterSap .

[in] CallMgrSapContext

Menentukan handel ke area konteks penduduk yang disediakan penelepon di mana CM mempertahankan status untuk SAP ini jika pendaftaran berhasil. Jika demikian, NDIS meneruskan handel ini kembali ke CM 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

Manajer panggilan mandiri harus memanggil NdisCmRegisterSapComplete jika fungsi ProtocolCmRegisterSap-nya dikembalikan NDIS_STATUS_PENDING ketika dipanggil dengan NdisSapHandle yang diberikan. Panggilan ke NdisCmRegisterSapComplete menyebabkan NDIS memanggil klien Fungsi ProtocolClRegisterSapComplete .

Jika manajer panggilan menetapkan Status ke apa pun selain NDIS_STATUS_SUCCESS, manajer panggilan harus menganggap NdisSapHandle tidak valid segera setelah memanggil NdisCmRegisterSapComplete. Setelah gagal dalam pendaftaran SAP, CM dapat merilis atau menggunakan kembali area konteks per-SAP yang dialokasikannya saat NdisCmRegisterSapComplete mengembalikan kontrol. NDIS juga merilis konteksnya untuk SAP jika manajer panggilan gagal pendaftaran.

Hanya manajer panggilan mandiri, yang mendaftarkan diri dengan NDIS sebagai driver protokol, yang dapat memanggil NdisCmRegisterSapComplete. Driver miniport berorientasi koneksi yang menyediakan panggilan dukungan manajemen panggilan terintegrasi NdisMCmRegisterSapComplete.

Persyaratan

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

Lihat juga

NdisAllocateFromNPagedLookasideList

NdisClRegisterSap

NdisMCmRegisterSapComplete

ProtocolClRegisterSapComplete

ProtocolCmRegisterSap