DML_ELEMENT_WISE_CLIP_OPERATOR_DESC結構 (directml.h)

針對 InputTensor 的每個元素執行下列作業，將結果放入 OutputTensor 的對應元素中。 這個運算子會 (或限制) 輸入中輸入中的每個元素在關閉間隔 [Min， Max] 內。

f(x) = max(Min, min(x, Max))

其中 max (a，b) 傳回兩個值中的較大值，而min (a，b) 傳回兩個值 a、b 的較小值。

此運算符支援就地執行，這表示 OutputTensor 可在系結期間將 InputTensor 別名化。

語法

struct DML_ELEMENT_WISE_CLIP_OPERATOR_DESC {
  const DML_TENSOR_DESC *InputTensor;
  const DML_TENSOR_DESC *OutputTensor;
  const DML_SCALE_BIAS  *ScaleBias;
  FLOAT                 Min;
  FLOAT                 Max;
};

成員

InputTensor

類型： const DML_TENSOR_DESC*

要從中讀取的輸入張量。

OutputTensor

類型： const DML_TENSOR_DESC*

要寫入結果的輸出張量。

ScaleBias

類型：_Maybenull_ const DML_SCALE_BIAS*

要套用至輸入的選擇性縮放比例和偏差。 如果存在，這會在計算這個運算符之前，將函 g(x) = x * scale + bias 式套用至每個 輸入 元素的效果。

Min

類型： FLOAT

運算子將值取代為 Min的最小值。

Max

類型： FLOAT

最大值，運算符會將值取代為 Max。

備註

如果 tensor 數據類型不是 float， 則 Min 和 Max 會在套用裁剪作業之前轉換成 tensor 數據類型 (，而整數則表示截斷為零;，用於將浮點值四捨五入至最接近的偶數) 。

可用性

這個運算子是在 中 DML_FEATURE_LEVEL_1_0引進的。

Tensor 條件約束

InputTensor 和 OutputTensor 必須具有相同 的 DataType、 DimensionCount 和 大小。

Tensor 支援

DML_FEATURE_LEVEL_5_0和更新版本

張	種類	支援的維度計數	支援的資料類型
InputTensor	輸入	1 到 8	FLOAT32、FLOAT16、INT64、INT32、INT16、INT8、UINT64、UINT32、UINT16、UINT8
OutputTensor	輸出	1 到 8	FLOAT32、FLOAT16、INT64、INT32、INT16、INT8、UINT64、UINT32、UINT16、UINT8

DML_FEATURE_LEVEL_3_0和更新版本

張	種類	支援的維度計數	支援的資料類型
InputTensor	輸入	1 到 8	FLOAT32、FLOAT16、INT32、INT16、INT8、UINT32、UINT16、UINT8
OutputTensor	輸出	1 到 8	FLOAT32、FLOAT16、INT32、INT16、INT8、UINT32、UINT16、UINT8

DML_FEATURE_LEVEL_2_1和更新版本

張	種類	支援的維度計數	支援的資料類型
InputTensor	輸入	4	FLOAT32、FLOAT16、INT32、INT16、INT8、UINT32、UINT16、UINT8
OutputTensor	輸出	4	FLOAT32、FLOAT16、INT32、INT16、INT8、UINT32、UINT16、UINT8

DML_FEATURE_LEVEL_1_0和更新版本

張	種類	支援的維度計數	支援的資料類型
InputTensor	輸入	4	FLOAT32、FLOAT16
OutputTensor	輸出	4	FLOAT32、FLOAT16

規格需求

需求	值
標頭	directml.h