UmsThreadYield 関数 (winbase.h)

  • [アーティクル]

呼び出し元の UMS ワーカー スレッドが実行されているユーザー モード スケジューリング (UMS) スケジューラ スレッドを制御します。

警告

Windows 11時点では、ユーザー モードのスケジュール設定はサポートされていません。 すべての呼び出しがエラー ERROR_NOT_SUPPORTEDで失敗します。

構文

BOOL UmsThreadYield(
  [in] PVOID SchedulerParam
);

パラメーター

[in] SchedulerParam

スケジューラ スレッドの UmsSchedulerProc 関数に渡す パラメーター。

戻り値

関数が成功すると、0 以外の値が返されます。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

UMS ワーカー スレッドは UmsThreadYield 関数を呼び出して、ワーカー スレッドが実行されている UMS スケジューラ スレッドに協調的に制御を提供します。 UMS ワーカー スレッドが UmsThreadYield を呼び出さない場合、ワーカー スレッドはブロックまたは終了するまで実行されます。

コントロールが UMS スケジューラ スレッドに切り替わると、システムは関連付けられたスケジューラ エントリ ポイント関数を呼び出します。その理由は UmsSchedulerThreadYield、および UmsThreadYield 呼び出しのワーカー スレッドで指定された ScheduleParam パラメーターです。

アプリケーションのスケジューラは、ワーカー スレッドの再スケジュールを担当します。

要件

   
サポートされている最小のクライアント Windows 7 (64 ビットのみ) [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winbase.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll
API セット api-ms-win-core-ums-l1-1-0 (Windows 7 で導入)

関連項目

UmsSchedulerProc