Fungsi PsLookupThreadByThreadId (ntifs.h)

Artikel
03/05/2024

Rutinitas PsLookupThreadByThreadId menerima ID utas utas dan mengembalikan penunjuk yang direferensikan ke struktur ETHREAD dari utas.

Sintaks

NTSTATUS PsLookupThreadByThreadId(
  [in]  HANDLE   ThreadId,
  [out] PETHREAD *Thread
);

Parameter

[in] ThreadId

Menentukan ID utas utas.

[out] Thread

Mengembalikan penunjuk yang direferensikan ke struktur utas ETHREAD yang ditentukan oleh ThreadId.

Nilai kembali

PsLookupThreadByThreadId mengembalikan STATUS_SUCCESS pada keberhasilan atau nilai NTSTATUS yang sesuai, seperti:

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	ID utas tidak ditemukan.

Keterangan

Rutinitas ini tersedia pada Windows 2000 dan versi yang lebih baru.

Jika panggilan ke PsLookupThreadByThreadId berhasil, PsLookupThreadByThreadId meningkatkan jumlah referensi pada objek yang dikembalikan dalam parameter Thread . Akibatnya, ketika driver telah selesai menggunakan parameter Thread , driver harus memanggil ObDereferenceObject untuk mendereferensikan parameter Thread yang diterima dari rutinitas PsLookupThreadByThreadId .

Struktur ETHREAD adalah struktur data buram yang digunakan secara internal oleh sistem operasi. Struktur ini dapat diteruskan ke rutinitas lain untuk mengakses informasi tertentu dalam struktur ini.

Driver filter sistem file dapat menghitung utas aktif dengan memanggil PsLookupThreadByThreadId untuk mengonversi ID utas ke struktur ETHREAD. ID utas tersedia di rutinitas pembuatan utas. Driver filter sistem file dapat mengatur rutinitas panggilan balik pemberitahuan utas menggunakan PsSetCreateThreadNotifyRoutine. Dalam rutinitas panggilan balik pemberitahuan, driver filter sistem file dapat menggunakan parameter ThreadId yang diteruskan dan memanggil PsLookupThreadByThreadId untuk menemukan struktur ETHREAD.

Rutinitas PsLookupThreadByThreadId berisi kode yang dapat di-pageable.