CreateUmsThreadContext 関数 (winbase.h)

UMS ワーカースレッドを表すユーザーモードスケジューリング (UMS) スレッドコンテキストを作成します。

警告

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

構文

BOOL CreateUmsThreadContext(
  [out] PUMS_CONTEXT *lpUmsThread
);

[out] lpUmsThread

PUMS_CONTEXT変数。出力時に、このパラメーターは UMS スレッドコンテキストへのポインターを受け取ります。

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

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。考えられるエラー値は次のとおりです。

リターンコード	説明
ERROR_NOT_ENOUGH_MEMORY	UMS スレッドコンテキストを作成するのに十分なメモリがありません。

UMS スレッドコンテキストは、UMS ワーカースレッドの状態を表します。スレッドコンテキストは、関数呼び出しで UMS ワーカースレッドを指定するために使用されます。

UMS ワーカースレッドは、InitializeProcThreadAttributeList と UpdateProcThreadAttribute を使用してスレッドの UMS 属性の一覧を準備した後、CreateRemoteThreadEx 関数を呼び出すことによって作成されます。

UMS スレッドコンテキストの基になる構造体はシステムによって管理されるため、直接変更しないでください。 UMS ワーカースレッドに関する情報を取得および設定するには、 QueryUmsThreadInformation 関数と SetUmsThreadInformation 関数を使用します。

UMS ワーカースレッドが終了した後は、 DeleteUmsThreadContext を呼び出して、そのスレッドコンテキストを解放する必要があります。

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