structured_task_group::run メソッド

[アーティクル]
08/09/2011

structured_task_group オブジェクトでタスクをスケジュールします。 _Task_handle パラメーターに渡される task_handle オブジェクトの有効期間は、呼び出し元によって管理されます。

template<
   class _Function
>
void run(
   task_handle<_Function>& _Task_handle
);

パラメーター

_Function
タスクハンドルの本体を実行するために呼び出される関数オブジェクトの型。
_Task_handle
スケジュールする作業を識別するハンドル。呼び出し元はこのオブジェクトの有効期間を管理します。ランタイムは、引き続き wait メソッドまたは run_and_wait メソッドがこの structured_task_group オブジェクトで呼び出されるまでオブジェクトが持続すると見なします。

解説

このメソッドに渡される処理関数のコピーは、ランタイムによって作成されます。このメソッドに渡した関数オブジェクトで発生した状態の変化は、その関数オブジェクトのコピーには反映されません。

例外からのスタックアンワインドの結果として structured_task_group が破棄される場合は、事前に wait メソッドまたは run_and_wait メソッドの呼び出しが行われたことを保証する必要はありません。その場合、デストラクターは適切に取り消し処理を行い、_Task_handle パラメーターで表されるタスクが完了するのを待ちます。

_Task_handle パラメーターによって指定されたタスクハンドルが run メソッドを介して既にタスクグループオブジェクトにスケジュールされていて、このタスクグループで wait メソッドまたは run_and_wait メソッドに対する中間の呼び出しがない場合、invalid_multiple_scheduling 例外がスローされます。