clCreateCommandQueue/1.0
提供: Tommy6
cl_command_queue clCreateCommandQueue (cl_context context, cl_device_id device, cl_command_queue_properties properties, cl_int *errcode_ret)
特定のOpenCLデバイスについてのコマンドキューを作成します。
パラメータ
- context
- 有効なOpenCLコンテキストを指定します。
- device
- 対象とするOpenCLデバイスを指定します。ここで指定するデバイスは context と関連付けられたものでなければなりません。ここでは、clCreateContext を利用して context を作成するときに指定したデバイスリスト内のデバイス、あるいは clCreateContextFromType を利用して context を作成したときに指定したデバイスタイプと同じデバイスタイプのデバイスのいずれも指定できます。
- properties
- コマンドキューのプロパティを指定するビットフィールドです。有効な値は以下のとおりです。
cl_command_queue_properties 解説 CL_QUEUE_OUT_OF_ORDER_EXEC_MODE_ENABLE このコマンドキューに挿入されるコマンドがインオーダーで実行されるのかアウトオブオーダーで実行されるのかを決定します。このプロパティを設定すると、コマンドキュー内のコマンドはアウトオブオーダーで実行されます。そうでないときはインオーダーで実行されます。 CL_QUEUE_PROFILING_ENABLE コマンドキュー内のコマンドのプロファイリングを有効にするか無効にするかを決定します。このプロパティを設定すると、コマンドのプロファイリングが有効になります。そうでないときは無効になります。
- errcode_ret
- 適切なエラーコードを返します。errcode_ret が NULL のとき、エラーコードは返されません。
エラー
コンテキストの作成が成功すると、clCreateCommandQueue は有効な非ゼロのコマンドキューを返し errcode_ret に CL_SUCCESS を設定します。そうでない場合は NULL を返して errcode_ret に以下のエラーのうちのひとつを設定します。
- CL_INVALID_CONTEXT - context が有効なOpenCLコンテキストでないとき。
- CL_INVALID_DEVICE - device が有効なOpenCLデバイスでないとき。あるいは、context と関連付けられていないとき。
- CL_INVALID_VALUE - properties に指定した値が有効なものでないとき。
- CL_INVALID_QUEUE_PROPERTIES - properties に指定した値が、有効であるもののデバイスがサポートしていないとき。
- CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。
変更記録
脚注
―――― Version 1.0, The OpenCL Specification
より翻訳
