accelerator_view 類別

發行項
10/12/2023

表示 C++ AMP 資料平行加速器上的虛擬裝置抽象概念。

語法

class accelerator_view;

成員

公用建構函式

名稱	描述
accelerator_view建構函式	初始化 `accelerator_view` 類別的新執行個體。
~accelerator_view解構函式	`accelerator_view`終結物件。

公用方法

名稱	描述
create_marker	傳回未來，以追蹤到目前為止提交給這個 `accelerator_view` 物件的所有命令完成。
flush	將所有排入佇列的暫止命令提交至 `accelerator_view` 加速器以執行。
get_accelerator	傳回 `accelerator` 物件的 `accelerator_view` 物件。
get_is_auto_selection	傳回布林值，指出當物件傳遞至 parallel_for_each 時 `accelerator_view` ，執行時間是否會自動選取適當的快速鍵。
get_is_debug	會傳回布林值，指出物件是否 `accelerator_view` 已啟用偵錯層以進行廣泛的錯誤報表。
get_queuing_mode	傳回物件的佇列模式 `accelerator_view` 。
get_version	傳回的版本 `accelerator_view` 。
等	等候提交至 `accelerator_view` 物件的所有命令完成。

公用運算子

名稱	描述
operator!=	比較這個 `accelerator_view` 物件與另一個物件，如果它們相同，則傳回 `false` ;否則會傳 `true` 回。
operator=	將指定 `accelerator_view` 之物件的內容複寫到這個物件中。
operator==	比較這個 `accelerator_view` 物件與另一個物件，如果它們相同，則傳回 `true` ;否則會傳 `false` 回。

公用資料成員

名稱	描述
加速器	取得 `accelerator_view` 物件的 `accelerator` 物件。
is_auto_selection	取得布林值，指出當物件傳遞至 parallel_for_each 時 `accelerator_view` ，執行時間是否會自動選取適當的快速鍵。
is_debug	取得布林值，指出物件是否 `accelerator_view` 已啟用偵錯層以進行廣泛的錯誤報表。
queuing_mode	取得物件的佇列模式 `accelerator_view` 。
version	取得加速器的版本。

繼承階層架構

accelerator_view

備註

accelerator_view物件代表快速鍵的邏輯隔離檢視。單一實體計算裝置可以有許多邏輯隔離 accelerator_view 物件。每個加速器都有預設 accelerator_view 物件。可以建立其他 accelerator_view 物件。

實體裝置可以在許多用戶端執行緒之間共用。用戶端執行緒可以合作使用加速器的相同 accelerator_view 物件，或者每個用戶端都可以透過獨立 accelerator_view 物件與計算裝置通訊，以與其他用戶端執行緒隔離。

accelerator_view物件可以有兩個queuing_mode列舉狀態之一。如果佇列模式為 immediate ，則和等 copyparallel_for_each 命令會在返回呼叫端時立即傳送至對應的加速器裝置。如果佇列模式為 deferred ，這類命令會在對應至 accelerator_view 物件的命令佇列上排入佇列。呼叫之前 flush() ，命令實際上不會傳送至裝置。

需求

標頭： amprt.h

命名空間： 並行

加速器

取得accelerator_view物件的快速鍵物件。

語法

__declspec(property(get= get_accelerator)) Concurrency::accelerator accelerator;

accelerator_view

藉由複製現有的 accelerator_view 物件，初始化 accelerator_view 類別的新實例。

語法

accelerator_view( const accelerator_view & other );

參數

other
要 accelerator_view 複製的物件。

create_marker

傳回未來，以追蹤到目前為止提交給這個 accelerator_view 物件的所有命令完成。

語法

concurrency::completion_future create_marker();

傳回值

未來，追蹤到目前為止提交給這個 accelerator_view 物件的所有命令完成。

flush

將所有排入佇列的暫止命令提交至accelerator_view物件，以執行加速器。

語法

void flush();

傳回值

傳回 void。

get_accelerator

傳回accelerator_view物件的快速鍵物件。

語法

accelerator get_accelerator() const;

傳回值

accelerator_view 物件的快速鍵物件。

get_is_auto_selection

會傳回 Boolean 值，指出當accelerator_view傳遞至 parallel_for_each 時，執行時間是否會自動選取適當的快速鍵。

語法

bool get_is_auto_selection() const;

傳回值

true 如果執行時間會自動選取適當的加速器，則為 ;否則為 false 。

get_is_debug

會傳回 Boolean 值，指出accelerator_view物件是否已啟用偵錯層，以便進行廣泛的錯誤報表。

語法

bool get_is_debug() const;

傳回值

布林值，指出物件是否 accelerator_view 已啟用針對廣泛的錯誤報表啟用 DEBUG 層。

get_queuing_mode

傳回accelerator_view物件的佇列模式。

語法

queuing_mode get_queuing_mode() const;

傳回值

物件的佇列模式 accelerator_view 。

get_version

傳回accelerator_view的版本。

語法

unsigned int get_version() const;

傳回值

的版本 accelerator_view 。

is_auto_selection

取得布林值，指出當accelerator_view傳遞至 parallel_for_each 時，執行時間是否會自動選取適當的快速鍵。

語法

__declspec(property(get= get_is_auto_selection)) bool is_auto_selection;

is_debug

取得布林值，指出accelerator_view物件是否已啟用偵錯層以進行廣泛的錯誤報表。

語法

__declspec(property(get= get_is_debug)) bool is_debug;

operator!=

比較這個accelerator_view物件與另一個物件，如果兩者相同，則傳回 false ，否則會傳 true 回。

語法

bool operator!= ( const accelerator_view & other ) const;

參數

other
要 accelerator_view 與這個物件比較的物件。

傳回值

如果這兩個物件相同則為 false，否則為 true。

operator=

將指定之accelerator_view物件的內容複寫到這個物件中。

語法

accelerator_view & operator= ( const accelerator_view & other );

參數

other
要 accelerator_view 從中複製的物件。

傳回值

已修改 accelerator_view 物件的參考。

operator==

比較這個accelerator_view物件與另一個物件，如果兩者相同，則傳回 true ，否則會傳 false 回。

語法

bool operator== ( const accelerator_view & other ) const;

參數

other
要 accelerator_view 與這個物件比較的物件。

傳回值

如果這兩個物件相同則為 true，否則為 false。

queuing_mode

取得accelerator_view物件的佇列模式。

語法

__declspec(property(get= get_queuing_mode)) Concurrency::queuing_mode queuing_mode;

version

取得accelerator_view的版本。

語法

__declspec(property(get= get_version)) unsigned int version;

wait

等候提交至accelerator_view物件的所有命令完成。

語法

void wait();

傳回值