_allow_cpu_features

構文

引数

説明

この組込み関数により、コード・ブロック・レベルで特定のプロセッサー機能を利用できます。この関数は、関数呼び出しに続くコードの有効範囲にのみ適用されます。コードブロックが特定の機能をサポートするプロセッサーでのみ実行されることを保証する必要があります。特定の機能をサポートしていないプロセッサーで実行すると、不正な命令例外によりプログラムが異常終了することがあります。

関数は、ビットマスクを引数として受け付けます。ある ISA が別の ISA に依存する場合、高位の ISA は通常下位の ISA を示します。例えば、次の引数は同じアセンブリー・コードを生成します。

• _FEATURE_SSE2|_FEATURE_AVX|_FEATURE_AVX512F

• _FEATURE_AVX512F

引数は、[Q]x や -m (Linux* および macOS*) または /arch (Windows*) オプションで指定されたプロセッサー向けに機能を追加することはできますが、機能を削除することはできません。

この関数だけでは、コンパイラーは複数のコードパスを生成しません。そのためには、_may_i_use_cpu_feature() を使用する必要があります。

関数レベルで特定のプロセッサー機能を利用するには、cpu_dispatch または cpu_specific 属性、あるいは optimization_parameter プラグマを使用します。

ファイルレベルで指定したプロセッサー機能を使用するには、[Q]x コンパイラー・オプションを使用します。

次の例は、この組込み関数により、プロセッサーのインテル® アドバンスト・ベクトル・エクステンション (インテル® AVX) 機能とインテル® ストリーミング SIMD 拡張命令 2 (インテル® SSE2) 機能を使用するコードを生成する方法を示します。

#include <string.h>
#include <immintrin.h> 

#define MAXIMGS            20
#define MAXNAME            512

typedef struct {
  int x;                  /* イメージの X 軸のサイズ */
  int y;                  /* イメージの Y 軸のサイズ */
  int bpp;                /* イメージのビット数 */
  char name[MAXNAME];     /* イメージの完全なファイル名 */
  unsigned char * data;   /* イメージの生データ (バイト) へのポインター */
} rawimage;

extern rawimage * imagelist[MAXIMGS];
extern int numimages;

rawimage* CreateImage(char * filename) 
{ 
       rawimage* newimage = NULL;
       int i, len, intable;

       intable=0;
       if (numimages!=0) {

             _allow_cpu_features(_FEATURE_SSE2 | _FEATURE_AVX);
             for (i=0; i<numimages; i++) {
                    if (!strcmp(filename, imagelist[i]->name)) {
                           newimage=imagelist[i];
                           intable=1;
                    }
             }
       }

       if (!intable) {
             newimage=(rawimage *)malloc(sizeof(rawimage));
             if (newimage != NULL) {
                    strcpy(newimage->name, filename);

                    imagelist[numimages]=newimage;  /* 新しいイメージをテーブルに追加 */ 
                    numimages++;                    /* イメージ数をインクリメント */
             }
       }

       return newimage;
}

戻り値

なし。