DeleteUmsThreadContext 関数 (winbase.h)

指定したユーザーモードスケジューリング (UMS) スレッドコンテキストを削除します。スレッドは終了する必要があります。

警告

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

構文

BOOL DeleteUmsThreadContext(
  [in] PUMS_CONTEXT UmsThread
);

[in] UmsThread

削除する UMS スレッドコンテキストへのポインター。 CreateUmsThreadContext 関数は、このポインターを提供します。

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

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

関連付けられたスレッドが終了するまで、UMS スレッドコンテキストを削除することはできません。

UMS ワーカースレッドの実行が完了すると (たとえば、スレッドエントリポイント関数から戻るなど)、システムはスレッドを終了し、スレッドの UMS スレッドコンテキストで終了状態を設定し、UMS スレッドコンテキストを関連付けられた完了リストにキューに入れます。

UMS スレッドが既に終了しているため、UMS スレッドを実行しようとすると失敗します。

スレッドの終了状態をチェックするには、アプリケーションのスケジューラで、UmsIsThreadTerminated 情報クラスを使用して QueryUmsThreadInformation を呼び出す必要があります。


サポートされている最小のクライアント	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 で導入)