avRtJoinThreadOrderingGroup 函式 (avrt.h)

將用戶端執行緒聯結至執行緒排序群組。

語法

AVRTAPI BOOL AvRtJoinThreadOrderingGroup(
  [out] PHANDLE Context,
  [in]  GUID    *ThreadOrderingGuid,
  [in]  BOOL    Before
);

[out] Context

內容控制碼的指標。

[in] ThreadOrderingGuid

執行緒排序群組的唯一識別碼指標。

[in] Before

執行緒順序。如果此參數為 TRUE，則執行緒是排定在父執行緒之前執行的前置執行緒。如果此參數為 FALSE，執行緒是排定在父執行緒之後執行的後續執行緒。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

執行緒會在 AvRtWaitOnThreadOrderingGroup 函式所控制的迴圈內，括住要在每個期間內執行的程式碼。

執行緒可以建立一個以上的執行緒排序群組，並聯結一個以上的執行緒排序群組。不過，執行緒無法聯結同一個執行緒排序群組一次以上。

可以加入群組的執行緒數目只受限於可用的系統資源。