デバイス上でのみメモリーを割り当てる

targetptr

targetptr 修飾子は、インテル® MIC アーキテクチャー上でのみメモリーを割り当てます。

alloc_if(1) でメモリー割り当てを行う際に targetptr 修飾子を指定すると、CPU 変数はインテル® MIC アーキテクチャー上に割り当てられたメモリーアドレスで更新されます。 この値は CPU では意味がないため、有効な CPU アドレスが割り当てられない限り、オフロードプラグマのデータ転送元/転送先としてのみ使用できます。

targetptr 修飾子は、オフロードが必須の場合のみ使用できます。 targetptr と同時に指定できるオフロード修飾子は、align と alloc です。

alloc_if 修飾子と free_if 修飾子は、インテル® MIC アーキテクチャー上でのメモリー割り当て/割り当て解除を制御し、さらにオフロードランタイムによって管理されるランタイムテーブルへ割り当てられたメモリー範囲を追加/削除します。

次の例は、#pragma offload_transfer、#pragma offload、および targetptr 修飾子を使用してメモリーを割り当てます。

01 #define ALLOC  alloc_if(1) free_if(0)
02 #define REUSE  alloc_if(0) free_if(0)
03 #define FREE   alloc_if(0) free_if(1)
 
10 int* cpu_p = (int*)malloc(1000*sizeof(int));
11 __declspec(target(mic)) int* mic_p;
 
20 // targetptr を指定してインテル® MIC アーキテクチャー上にメモリーを割り当てます
21 // mic_p の値は、割り当て前は未定義、割り当て後は MIC 上のメモリーアドレスになります
22 #pragma offload_transfer target(mic) \
23   nocopy(mic_p[0:1000] : ALLOC targetptr)
 
30 // CPU からインテル® MIC アーキテクチャーへデータを転送し、処理を行います
31 #pragma offload target(mic) \
32   in(cpu_p[0:1000] : into(mic_p[0:1000]) REUSE targetptr)
33 {
34      … = *mic_p; // mic_p で指定されたデータを使用します
35     *mic_p = …   // mic_p で指定された値を更新します
36 }
 
40 // インテル® MIC アーキテクチャーから CPU へデータを転送し、メモリーを解放します
41 #pragma offload_transfer target(mic) \
42   out(mic_p[0:1000] : into(cpu_p[0:1000]) FREE targetptr)

preallocated targetptr

preallocated 修飾子と targetptr 修飾子を同時に使用してインテル® MIC アーキテクチャー上でメモリーを割り当てることができます。 これらの修飾子を使用すると、ユーザーによって割り当て済みのインテル® MIC アーキテクチャー上のメモリーがデータ転送で利用可能になります。

alloc_if 修飾子と free_if 修飾子は、オフロード・ライブラリー・テーブルへの追加/削除にのみ影響し、メモリー割り当てはプログラマーが行います。

preallocated targetptr alloc_if(1) は、in 節とともに使用することはできません。インテル® MIC アーキテクチャー上ではメモリーを割り当て済みですが、そのメモリーアドレスがまだ CPU 上でデータ転送に利用できないためです。 out 節または nocopy 節とともに使用することはできます。 オフロードの終了時に、インテル® MIC アーキテクチャー上のメモリーアドレスが CPU に送られます。CPU 上に送られた変数は、以降のオフロードでメモリーアクセスに利用できます。

次の表は、preallocated targetptr と in、out、inout、nocopy 節、および alloc_if、free_if 修飾子を組み合わせて使用した場合の動作の説明です。

preallocated 修飾子は、オフロードが必須の場合のみ有効です。 オフロードがオプションの場合、メモリー割り当てを行うオフロードが実行されないと、割り当て済みメモリーを使用する以降のオフロードは失敗します。

preallocated 修飾子はプログラマーによってメモリーが割り当てられるため、align 修飾子と同時に使用することはできません。

alloc 修飾子は同時に使用することができます。

次の例は、#pragma offload と #pragma offload を使用してメモリーを割り当てます。

01 // malloc を使用してインテル® MIC アーキテクチャー上にメモリーを割り当て、登録します
02 #pragma offload target(mic) \
03   nocopy(mic_p[0:1000] ALLOC preallocated targetptr )
04 {
05      mic_p = user_malloc(1000*sizeof(int));
06 }
 
10 // CPU からインテル® MIC アーキテクチャーへデータを転送し、処理を行います
11 #pragma offload target(mic) \
12   in(cpu_p[0:1000] : into(mic_p[0:1000]) REUSE targetptr )
13 {
14      = *mic_p;
15     *mic_p = …
16 }
 
20 // インテル® MIC アーキテクチャー上のメモリー登録を削除し、メモリーを解放します
21 #pragma offload target(mic) \
22   nocopy(mic_p : FREE preallocated targetptr )
23 {
24      free(mic_p);
25 }