Fungsi FltApplyPriorityInfoThread (fltkernel.h)

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 mengatur 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 tempat menerapkan informasi prioritas InputPriorityInfo . Parameter ini diperlukan dan tidak boleh NULL.

Mengembalikan nilai

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

   
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

Lihat juga

FLT_CALLBACK_DATA

FltGetIoPriorityHint

FltGetIoPriorityHintFromCallbackData

FltGetIoPriorityHintFromFileObject

FltGetIoPriorityHintFromThread

FltRetrieveIoPriorityInfo

FltSetIoPriorityHintIntoCallbackData

FltSetIoPriorityHintIntoFileObject

FltSetIoPriorityHintIntoThread

IO_PRIORITY_INFO