「clGetMemObjectInfo/1.0」の版間の差分

全てのメモリオブジェクト（バッファオブジェクトおよびイメージオブジェクト）に共通の情報を取得します。

パラメータ

memobj

メモリオブジェクトを指定します。

param_name

取得する情報を指定します。下記の表にある定数からひとつ選んで指定できます。

param_value

下記の表にしたがって param_name に指定した情報についての値が返されるメモリ空間へのポインタです。NULL の場合は無視されます。

param_value_size

param_value が指すメモリのサイズをバイトで指定します。このサイズは、下記の表で示されている戻り値型のサイズ以上でなければなりません。

param_value_size_ret

param_value にコピーされるデータの実際のサイズをバイトで返します。NULL の場合は無視されます。

取得できる情報

param_name で指定できる情報およびこれに対応して param_value に返される情報を以下の表に示しています。

エラー

実行が成功した場合、clGetMemObjectInfo は CL_SUCCESS を返します。param_name がサポートされている値でない、あるいは、param_value_size で指定されたサイズが上記の表で指定されている戻り値型のサイズより小さくかつ param_value が NULL でないとき、CL_INVALID_VALUE を返します。memobj が有効なメモリオブジェクトでないとき、CL_INVALID_MEM_OBJECT を返します。

変更記録

脚注

1. ↑ 返されたマップカウントの値はすぐに古くなるものと考えるべきです。アプリケーションでの一般的な使用には向いていません。この機能はデバッグのために提供されています。
2. ↑ 返された参照カウントの値はすぐに古くなるものと考えるべきです。アプリケーションでの一般的な使用には向いていません。この機能はメモリリークを検出するために提供されています。