NDK_FN_CLOSE_OBJECT fungsi panggilan balik (ndkpi.h)

Fungsi NdkCloseObject (NDK_FN_CLOSE_OBJECT) memulai permintaan tutup untuk objek NDK.

Sintaks

NDK_FN_CLOSE_OBJECT NdkFnCloseObject;

NTSTATUS NdkFnCloseObject(
  [in]           NDK_OBJECT_HEADER *pNdkObject,
  [in]           NDK_FN_CLOSE_COMPLETION CloseCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkObject

Penunjuk ke header objek (NDK_OBJECT_HEADER) agar objek ditutup.

[in] CloseCompletion

Penunjuk ke fungsi panggilan balik penyelesaian penutupan NdkCloseCompletion (NDK_FN_CLOSE_COMPLETION).

[in, optional] RequestContext

Nilai konteks untuk penyedia NDK untuk diteruskan kembali ke fungsi NdkCloseCompletion yang ditentukan dalam parameter CloseCompletion .

Nilai kembali

Fungsi NdkCloseObject mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode Deskripsi
STATUS_SUCCESS
Objek NDK ditutup. Penyedia tidak akan memanggil fungsi NdkCloseCompletion .
STATUS_PENDING
Permintaan tertunda, penyedia akan memanggil fungsi NdkCloseCompletion untuk menyelesaikan operasi secara asinkron. Permintaan penutupan telah berhasil dimulai, tetapi mungkin tidak selesai.
Kode status lainnya
Terjadi kesalahan.

Keterangan

Tabel pengiriman fungsi untuk setiap jenis objek NDK menyertakan penunjuk fungsi NDK_FN_CLOSE_OBJECT . Permintaan penutupan bersifat asinkron. Konsumen NDK tidak boleh mengakses objek setelah permintaan penutupan dimulai.

Penyedia NDK harus memastikan bahwa fungsi NdkCloseCompletion (NDK_FN_CLOSE_COMPLETION) adalah panggilan balik terakhir yang dipanggil untuk objek yang ditutup. Penyedia harus memastikan bahwa semua permintaan asinkron yang luar biasa selesai dan semua panggilan balik yang sedang berlangsung telah kembali dan panggilan balik lebih lanjut dicegah sebelum penyedia memanggil fungsi NdkCloseCompletion . Setelah penyedia memanggil fungsi NdkCloseCompletion , penyedia tidak memanggil fungsi penyelesaian atau fungsi panggilan balik pemberitahuan untuk objek.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tidak ada yang didukung, Didukung di NDIS 6.30 dan yang lebih baru.
Server minimum yang didukung Windows Server 2012
Target Platform Windows
Header ndkpi.h (termasuk Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Lihat juga

Persyaratan Seumur Hidup Objek NDKPI

NDK_CONNECTOR_DISPATCH

NDK_CQ_DISPATCH

NDK_FN_CLOSE_COMPLETION

NDK_OBJECT_HEADER