BitmapEncoder.CreateForInPlacePropertyEncodingAsync(BitmapDecoder) 方法

定義

命名空間:

Windows.Graphics.Imaging

以非同步方式建立新的 BitmapEncoder 以進行就地屬性和中繼資料編輯。 新的編碼器只能就地編輯點陣圖屬性，而且任何其他用途都會失敗。

public:
 static IAsyncOperation<BitmapEncoder ^> ^ CreateForInPlacePropertyEncodingAsync(BitmapDecoder ^ bitmapDecoder);

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<BitmapEncoder> CreateForInPlacePropertyEncodingAsync(BitmapDecoder const& bitmapDecoder);

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BitmapEncoder> CreateForInPlacePropertyEncodingAsync(BitmapDecoder bitmapDecoder);

function createForInPlacePropertyEncodingAsync(bitmapDecoder)

Public Shared Function CreateForInPlacePropertyEncodingAsync (bitmapDecoder As BitmapDecoder) As IAsyncOperation(Of BitmapEncoder)

參數

bitmapDecoder

BitmapDecoder

BitmapDecoder，其中包含要編輯的影像資料。 此參數必須在具有 ReadWrite存取模式的資料流程上建立。

注意

編碼器會寫入原始 BitmapDecoder 建立所在的資料流程。 您無法指定輸出資料流程。

傳回

IAsyncOperation<BitmapEncoder>

物件，使用現有BitmapDecoder 的資料來管理新 BitmapEncoder的非同步初始化。

屬性

RemoteAsyncAttribute

備註

當您只將它用來編輯或將有限數量的屬性寫入影像時，請使用此方法來擷取編碼器。 透過這種方式擷取的編碼器，可以透過 CreateForTranscodingAsync 傳回的編碼器提供效能優勢，因為它會將新的屬性寫入空白填補空間，而不是再次編碼整個影像。

以下是以這種方式擷取編碼器的數個限制：

• 您只能在編碼器上使用這些方法：
  • BitmapEncoder.BitmapProperties.GetPropertiesAsync
  • BitmapEncoder.BitmapProperties.SetPropertiesAsync
  • 如果您呼叫 BitmapEncoder.FlushAsync 任何其他方法將會失敗。
• 輸入 BitmapDecoder 必須是在具有 ReadWrite 存取權的資料流程上建立的編碼器。
• 並非所有元資料格式都支援快速的中繼資料編碼。 支援中繼資料的原生元資料處理程式為 IFD、Exif、XMP 和 GPS。
• 中繼資料區塊必須有足夠的填補，才能儲存您嘗試編輯的屬性。 如果編碼作業因故失敗，您必須使用 CreateForTranscodingAsync 來編輯中繼資料並重新編碼影像。 當您重新編碼時，也可以加入新的或其他填補，以在未來啟用就地屬性編碼。 若要這樣做，請建立新的 BitmapTypedValue ，並將 Type 設定為 UInt32，並將 Value 設定為您想要新增的填補位元組數目。 一般值為 4096 個位元組。 在此資料表的一或多個中繼資料查詢位置上設定此中繼資料專案。

  中繼資料格式	JPEG 中繼資料查詢	TIFF、JPEG-XR 中繼資料查詢
  IFD	/app1/ifd/PaddingSchema：Padding	/ifd/PaddingSchema：Padding
  Exif	/app1/ifd/exif/PaddingSchema：Padding	/ifd/exif/PaddingSchema：Padding
  XMP	/xmp/PaddingSchema：Padding	/ifd/xmp/PaddingSchema：Padding
  GPS	/app1/ifd/gps/PaddingSchema：Padding	/ifd/gps/PaddingSchema：Padding