Fungsi FltPerformSynchronousIo (fltkernel.h)

Artikel
02/29/2024

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:

FltClose

FltCreateFile

FltQueryInformationFile

FltQueryVolumeInformation

FltReadFile

FltSetInformationFile

FltSetVolumeInformation

FltTagFile

FltUntagFile

FltWriteFile

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.