GetThreadWaitChain

指定したスレッドの待機チェーンを取得する。

GetThreadWaitChain WctHandle, Context, Flags, ThreadId, NodeCount, NodeInfoArray, IsCycle

WctHandle : [intptr] OpenThreadWaitChainSession 関数で作成した WCT セッションへのハンドル。
Context : [int] 非同期セッションのコールバック関数に渡される、アプリケーション定義のコンテキスト構造体へのポインタ。
Flags : [int] 
ThreadId : [int] スレッドの識別子。
NodeCount : [var] 入力時は、待機チェーン内のノード数を指定する 1 から WCT_MAX_NODE_COUNT までの値。戻り時は、取得されたノード数。配列が待機チェーンの全ノードを格納できない場合、関数は失敗し、GetLastError は ERROR_MORE_DATA を返し、このパラメータには全ノードを格納するために必要な配列要素数が格納される。非同期セッションでは、コールバック関数に渡される値を確認する。コールバック関数が戻るまで変数を解放してはならない。
NodeInfoArray : [var] 待機チェーンを受け取る WAITCHAIN_NODE_INFO 構造体の配列。非同期セッションでは、コールバック関数に渡される値を確認する。コールバック関数が戻るまで配列を解放してはならない。
IsCycle : [var] 関数がデッドロックを検出した場合、この変数は TRUE に設定される。それ以外は FALSE に設定される。非同期セッションでは、コールバック関数に渡される値を確認する。コールバック関数が戻るまで変数を解放してはならない。

(プラグイン / モジュール : advapi32.dll)

解説

指定したスレッドの待機チェーンを取得する。

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 である。拡張エラー情報を取得するには
GetLastError を呼び出す。
（以下省略）

[備考]
セッションが非同期の場合、関数は FALSE を返し、GetLastError は ERROR_IO_PENDING
を返す。結果を取得するには WaitChainCallback
コールバック関数を参照。指定したスレッドがブロックされていないか、サポートされていない同期オブジェクトでブロックされている場合、関数は
NodeInfoArray に 1 個の項目を返す。呼び出し元は SE_DEBUG_NAME
特権を持っている必要がある。呼び出し元の権限が不足している場合、最初のスレッドにアクセスできないと関数は失敗する。それ以外の場合は、配列の最後のノードの
ObjectStatus メンバが WctStatusNoAcces
に設定される。配列内のノードの部分集合がサイクルを形成している場合、関数は IsCycle パラメータを TRUE
に設定する。待機チェーン情報は動的である。関数呼び出し時点では正しいが、呼び出し元が確認する時点では古くなっている可能性がある。

情報