PROTOCOL_CM_CLOSE_AF fungsi panggilan balik (ndis.h)
Fungsi ProtocolCmCloseAf adalah fungsi yang diperlukan yang merilis sumber daya per terbuka untuk keluarga alamat yang didukung manajer panggilan.
Sintaks
PROTOCOL_CM_CLOSE_AF ProtocolCmCloseAf;
NDIS_STATUS ProtocolCmCloseAf(
[in] NDIS_HANDLE CallMgrAfContext
)
{...}
Parameter
[in] CallMgrAfContext
Menentukan handel ke area konteks per AF manajer panggilan, yang awalnya disediakan ke NDIS oleh fungsi ProtocolCmOpenAf manajer panggilan.
Nilai kembali
ProtocolCmCloseAf mengembalikan status operasinya sebagai salah satu dari berikut ini:
Menampilkan kode | Deskripsi |
---|---|
|
Menunjukkan bahwa pengelola panggilan telah berhasil merilis atau menonaktifkan sumber daya apa pun yang dialokasikan atas nama klien berorientasi koneksi yang membuka instans keluarga alamat ini. |
|
Menunjukkan bahwa permintaan untuk menutup instans terbuka dari keluarga alamat akan diselesaikan secara asinkron. Manajer panggilan harus memanggil NdisCmCloseAddressFamilyComplete ketika semua operasi tersebut telah selesai. |
Keterangan
ProtocolCmCloseAf merilis dan/atau menonaktifkan sumber daya apa pun yang dialokasikan oleh manajer panggilan dalam fungsi ProtocolCmOpenAf-nya . Manajer panggilan juga harus membatalkan tindakan lain yang diambil atas nama klien yang berorientasi pada koneksi ketika keluarga alamat dibuka oleh klien tersebut.
Jika ada permintaan atau koneksi yang luar biasa yang masih terbuka pada keluarga alamat yang disimpan di CallMgrAfContext, manajer panggilan dapat menanggapi permintaan klien untuk menutup keluarga alamat dengan salah satu cara berikut:
- Manajer panggilan dapat gagal dalam permintaan dengan NDIS_STATUS_NOT_ACCEPTED.
- Manajer panggilan dapat mengembalikan NDIS_STATUS_PENDING. Setelah klien menutup semua panggilan dan membatalkan pendaftaran semua SAP, manajer panggilan kemudian dapat menutup keluarga alamat dan memanggil NdisCmCloseAddressFamilyComplete atau NdisMCmCloseAddressFamilyComplete untuk memberi tahu klien. Ini adalah respons yang disukai.
Contoh
Untuk menentukan fungsi ProtocolCmCloseAf , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis fungsi yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi untuk pengandar. Mendeklarasikan fungsi menggunakan jenis fungsi membantu Analisis Kode untuk Driver, Pemverifikasi Driver Statis (SDV), dan alat verifikasi lainnya menemukan kesalahan, dan itu adalah persyaratan untuk menulis driver untuk sistem operasi Windows.Misalnya, untuk menentukan fungsi ProtocolCmCloseAf yang diberi nama "MyCmCloseAf", gunakan jenis PROTOCOL_CM_CLOSE_AF seperti yang ditunjukkan dalam contoh kode ini:
PROTOCOL_CM_CLOSE_AF MyCmCloseAf;
Kemudian, terapkan fungsi Anda sebagai berikut:
_Use_decl_annotations_
NDIS_STATUS
MyCmCloseAf(
NDIS_HANDLE CallMgrAfContext
)
{...}
Jenis fungsi PROTOCOL_CM_CLOSE_AF didefinisikan dalam file header Ndis.h. Untuk mengidentifikasi kesalahan secara lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan anotasi Use_decl_annotations ke definisi fungsi Anda. Anotasi Use_decl_annotations memastikan bahwa anotasi yang diterapkan ke jenis fungsi PROTOCOL_CM_CLOSE_AF dalam file header digunakan. Untuk informasi selengkapnya tentang persyaratan untuk deklarasi fungsi, lihat Mendeklarasikan Fungsi dengan Menggunakan Jenis Peran Fungsi untuk Driver NDIS.
Untuk informasi tentang Use_decl_annotations, lihat Perilaku Fungsi Anotasi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat ProtocolCmCloseAf (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat ProtocolCmCloseAf (NDIS 5.1)) di Windows XP. |
Target Platform | Windows |
Header | ndis.h (termasuk Ndis.h) |
IRQL | <= DISPATCH_LEVEL |
Lihat juga
NdisCmCloseAddressFamilyCompleteSaran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk