PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK fungsi panggilan balik (ntifs.h)

Artikel
02/26/2024

Driver filter dapat mendaftarkan rutinitas yang ditik PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK sebagai rutinitas panggilan balik CleanupCallback driver filter untuk struktur konteks parameter buat tambahan (ECP).

Sintaks

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK PfsrtlExtraCreateParameterCleanupCallback;

void PfsrtlExtraCreateParameterCleanupCallback(
  [in, out] PVOID EcpContext,
  [in[]     LPCGUID EcpType
)
{...}

Parameter

[in, out] EcpContext

Penunjuk konteks ECP yang dikembalikan oleh rutinitas yang mengalokasikan struktur konteks ECP.

[in[] EcpType

Pointer ke GUID yang diteruskan ke rutinitas yang mengalokasikan struktur konteks ECP, yang menunjukkan jenis parameter buat ekstra. Untuk informasi selengkapnya, lihat Menggunakan GUID di Driver.

Nilai kembali

Tidak ada

Keterangan

Ketika driver filter mengalokasikan struktur konteks ECP, secara opsional dapat menentukan rutinitas yang ditik PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK sebagai rutinitas panggilan balik CleanupCallback driver filter. Jika driver filter menentukan rutinitas panggilan balik CleanupCallback , sistem operasi akan memanggil rutinitas CleanupCallback (terlepas dari tingkat IRQ). Rutinitas CleanupCallback ini melakukan pemrosesan pembersihan terkait konteks ECP yang diperlukan saat struktur konteks ECP dihapus.

Untuk menentukan rutinitas panggilan balik, driver filter meneruskan penunjuk ke rutinitas panggilan balik dengan menggunakan parameter CleanupCallback dari rutinitas yang awalnya mengalokasikan struktur konteks ECP. Jika rutinitas panggilan balik tidak diperlukan, nilai NULL harus diteruskan ke parameter CleanupCallback .

Rutinitas berikut mendukung rutinitas panggilan balik PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK- ketik: