Fungsi panggilan balik PWAITCHAINCALLBACK (wct.h)

Artikel
03/13/2024

Fungsi panggilan balik yang ditentukan aplikasi yang menerima rantai tunggu. Tentukan alamat ini saat memanggil fungsi OpenThreadWaitChainSession .

Jenis PWAITCHAINCALLBACK mendefinisikan penunjuk ke fungsi panggilan balik ini. WaitChainCallback adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

PWAITCHAINCALLBACK Pwaitchaincallback;

void Pwaitchaincallback(
  HWCT WctHandle,
  DWORD_PTR Context,
  DWORD CallbackStatus,
  LPDWORD NodeCount,
  PWAITCHAIN_NODE_INFO NodeInfoArray,
  LPBOOL IsCycle
)
{...}

Parameter

WctHandle

Handel ke sesi WCT yang dibuat oleh fungsi OpenThreadWaitChainSession .

Context

Penunjuk opsional ke struktur konteks yang ditentukan aplikasi yang ditentukan oleh fungsi GetThreadWaitChain .

CallbackStatus

Status panggilan balik. Parameter ini bisa menjadi salah satu nilai berikut, atau salah satu kode kesalahan sistem lainnya.

Nilai	Makna
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki hak istimewa yang memadai untuk membuka utas target.
ERROR_CANCELLED	Sesi asinkron dibatalkan oleh panggilan ke fungsi CloseThreadWaitChainSession .
ERROR_MORE_DATA	Buffer NodeInfoArray tidak cukup besar untuk berisi semua simpul dalam rantai tunggu. Parameter NodeCount berisi jumlah simpul dalam rantai. Rantai tunggu yang dikembalikan masih valid.
ERROR_OBJECT_NOT_FOUND	Utas yang ditentukan tidak dapat ditemukan.
ERROR_SUCCESS	Operasi berhasil diselesaikan.
ERROR_TOO_MANY_THREADS	Jumlah simpul melebihi WCT_MAX_NODE_COUNT. Rantai tunggu yang dikembalikan masih valid.

NodeCount

Jumlah simpul yang diambil, hingga WCT_MAX_NODE_COUNT. Jika array tidak dapat berisi semua simpul rantai tunggu, fungsi gagal, CallbackStatus ERROR_MORE_DATA, dan parameter ini menerima jumlah elemen array yang diperlukan untuk berisi semua simpul.

NodeInfoArray

Array struktur WAITCHAIN_NODE_INFO yang menerima rantai tunggu.

IsCycle

Jika fungsi mendeteksi kebuntuan, variabel ini diatur ke TRUE; jika tidak, ini diatur ke FALSE.

Nilai kembali

Tidak ada

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wct.h

Lihat juga

GetThreadWaitChain

OpenThreadWaitChainSession

WAITCHAIN_NODE_INFO

Bagikan melalui