Fungsi FltPerformSynchronousIo (fltkernel.h)
Driver minifilter memanggil FltPerformSynchronousIo untuk memulai operasi I/O sinkron setelah memanggil FltAllocateCallbackData untuk mengalokasikan struktur data panggilan balik untuk operasi.
Sintaks
VOID FLTAPI FltPerformSynchronousIo(
[in, out] PFLT_CALLBACK_DATA CallbackData
);
Parameter
[in, out] CallbackData
Arahkan ke struktur data panggilan balik (FLT_CALLBACK_DATA) yang dialokasikan oleh panggilan sebelumnya ke FltAllocateCallbackData. Parameter ini diperlukan dan tidak boleh NULL. Pemanggil bertanggung jawab untuk membebaskan struktur ini ketika tidak lagi diperlukan dengan memanggil FltFreeCallbackData.
Nilai kembali
Tidak ada
Keterangan
Driver minifilter memanggil FltPerformSynchronousIo untuk memulai operasi I/O sinkron.
Driver minifilter hanya dapat memulai operasi I/O berbasis IRP. Mereka tidak dapat memulai operasi panggilan balik I/O atau filter sistem file (FSFilter) yang cepat.
FltPerformSynchronousIo mengirimkan operasi I/O hanya ke instans driver minifilter yang terpasang di bawah instans yang memulai (ditentukan dalam parameter Instans ke FltAllocateCallbackData), dan sistem file. Driver minifilter yang terpasang di atas instans yang ditentukan tidak menerima operasi I/O.
Driver minifilter harus menggunakan FltPerformSynchronousIo hanya dalam kasus di mana rutinitas seperti berikut ini tidak dapat digunakan:
Setelah FltPerformSynchronousIo kembali, pemanggil dapat menerbitkan ulang operasi I/O dengan memanggil FltReissueSynchronousIo. Atau, pemanggil dapat membebaskan struktur data panggilan balik (FLT_CALLBACK_DATA) dengan memanggil FltFreeCallbackData atau mempersiapkannya untuk digunakan kembali dengan memanggil FltReuseCallbackData.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | fltkernel.h (termasuk Fltkernel.h) |
Pustaka | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |