Fungsi FltApplyPriorityInfoThread (fltkernel.h)

Artikel
08/07/2023

Rutinitas FltApplyPriorityInfoThread digunakan oleh driver minifilter untuk menerapkan informasi prioritas ke utas.

Sintaks

NTSTATUS FLTAPI FltApplyPriorityInfoThread(
  [in]            PIO_PRIORITY_INFO InputPriorityInfo,
  [out, optional] PIO_PRIORITY_INFO OutputPriorityInfo,
  [in]            PETHREAD          Thread
);

Parameter

[in] InputPriorityInfo

Penunjuk ke struktur IO_PRIORITY_INFO yang digunakan untuk mengatur status prioritas utas yang diberikan. Struktur IO_PRIORITY_INFO ini harus menetapkan anggotanya dengan rutinitas yang sesuai - lihat bagian Keterangan berikut. Parameter ini diperlukan dan tidak boleh NULL.

[out, optional] OutputPriorityInfo

Penunjuk opsional ke struktur IO_PRIORITY_INFO yang digunakan untuk menerima status prioritas utas sebelum informasi prioritas InputPriorityInfo diterapkan ke utas oleh FltApplyPriorityInfoThread. Parameter ini bersifat opsional dan dapat berupa NULL.

[in] Thread

Penunjuk ke utas untuk menerapkan informasi prioritas InputPriorityInfo . Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

Jika informasi prioritas utas, yang ditunjukkan oleh parameter InputPriorityInfo , berhasil diterapkan ke utas yang diberikan, rutinitas FltApplyPriorityInfoThread mengembalikan STATUS_SUCCESS. Jika tidak, nilai NTSTATUS yang sesuai akan ditampilkan, seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER_1	Struktur yang diacu oleh parameter InputPriorityInfo diinisialisasi tetapi satu atau beberapa nilai anggotanya tidak valid. Ini adalah kode kesalahan.

Keterangan

Rutinitas ini tersedia dimulai dengan Windows Vista.

Rutinitas FltApplyPriorityInfoThread menetapkan prioritas I/O, prioritas halaman, dan prioritas utas dari utas yang diberikan berdasarkan nilai anggota struktur IO_PRIORITY_INFO yang ditunjukkan oleh parameter InputPriorityInfo . Ini memungkinkan serangkaian informasi prioritas yang disimpan sebelumnya, yang diperoleh oleh rutinitas FltRetrieveIoPriorityInfo atau FltApplyPriorityInfoThread , untuk diterapkan ke utas.

Nilai asli utas target, sebelum nilai prioritas InputPriorityInfo diterapkan oleh rutinitas FltApplyPriorityInfoThread , dapat disimpan jika penunjuk OutputPriorityInfo yang valid disediakan. Perhatikan bahwa struktur yang ditujukkan oleh parameter OutputPriorityInfo tidak perlu diinisialisasi.

Aman untuk menyediakan pointer yang sama ke struktur IO_PRIORITY_INFO tunggal untuk parameter InputPriorityInfo dan OutputPriorityInfo .

Catatan Jika nilai anggota struktur IO_PRIORITY_INFO yang ditunjukkan oleh parameter InputPriorityInfo belum ditetapkan, Anda harus mengatur anggota ini, sebelum memanggil rutinitas FltApplyPriorityInfoThread , dengan menggunakan salah satu metode berikut:

Panggil rutinitas FltRetrieveIoPriorityInfo .
Pastikan bahwa parameter InputPriorityInfo saat ini adalah parameter OutputPriorityInfo dalam panggilan sebelumnya ke rutinitas FltApplyPriorityInfoThread .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows Vista dan versi sistem operasi Windows yang lebih baru.
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	Fltmgr.lib
IRQL	<= DISPATCH_LEVEL