IBitmapFrame.GetPixelDataAsync 方法

參考

定義

命名空間:: Windows.Graphics.Imaging

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

GetPixelDataAsync()	以非同步方式要求框架的圖元資料。產生的圖元資料陣列會使用 BitmapPixelFormat 和 BitmapAlphaMode 屬性中指定的點陣圖像素格式和 Alpha 模式。它也會套用色彩管理和 EXIF 方向 (如需詳細資訊，請參閱一節以取得詳細資訊) 。
GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)	使用指定的參數，以非同步方式要求框架的圖元資料。

GetPixelDataAsync()

編輯

以非同步方式要求框架的圖元資料。產生的圖元資料陣列會使用 BitmapPixelFormat 和 BitmapAlphaMode 屬性中指定的點陣圖像素格式和 Alpha 模式。它也會套用色彩管理和 EXIF 方向 (如需詳細資訊，請參閱一節以取得詳細資訊) 。

public:
 IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync();

/// [Windows.Foundation.Metadata.Overload("GetPixelDataAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<PixelDataProvider> GetPixelDataAsync();

[Windows.Foundation.Metadata.Overload("GetPixelDataAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<PixelDataProvider> GetPixelDataAsync();

function getPixelDataAsync()

Public Function GetPixelDataAsync () As IAsyncOperation(Of PixelDataProvider)

傳回

IAsyncOperation<PixelDataProvider>

管理圖元資料非同步擷取的物件。

屬性: OverloadAttribute RemoteAsyncAttribute

備註

應用程式不應該假設此方法所傳回的圖元資料會使用任何特定的像素格式或 Alpha 模式 (，也就是使用預先乘法 Alpha) 的 Rgba8。相反地，它應該一律檢查 BitmapPixelFormat 和 BitmapAlphaMode 屬性，並據以處理資料。

為了方便起見，此方法會從畫面格的內嵌色彩空間 (執行色彩管理，如果色彩空間存在) 至 sRGB 色彩空間，則會執行色彩管理。如果沒有內嵌色彩設定檔資料，則不會執行色彩管理。此方法也會嘗試讀取畫面上的 EXIF 方向旗標，如果存在，則會執行必要的轉換，以正確設定圖元資料的方向。

為了擷取正確的點陣圖圖元寬度和高度，應用程式應該讀取 OrientedPixelWidth 和 OrientedPixelHeight 屬性，而不是 PixelWidth 和 PixelHeight 屬性。

這個方法相當於使用下列引數呼叫 GetPixelDataAsync (BitmapPixelFormat、BitmapAlphaMode、BitmapTransform、ExifOrientationMode、ColorManagementMode) 方法：

引數值

*pixelFormat*

的值

另請參閱

GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

適用於

GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

編輯

使用指定的參數，以非同步方式要求框架的圖元資料。

public:
 IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, BitmapTransform ^ transform, ExifOrientationMode exifOrientationMode, ColorManagementMode colorManagementMode);

/// [Windows.Foundation.Metadata.Overload("GetPixelDataTransformedAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<PixelDataProvider> GetPixelDataAsync(BitmapPixelFormat const& pixelFormat, BitmapAlphaMode const& alphaMode, BitmapTransform const& transform, ExifOrientationMode const& exifOrientationMode, ColorManagementMode const& colorManagementMode);

[Windows.Foundation.Metadata.Overload("GetPixelDataTransformedAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<PixelDataProvider> GetPixelDataAsync(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, BitmapTransform transform, ExifOrientationMode exifOrientationMode, ColorManagementMode colorManagementMode);

function getPixelDataAsync(pixelFormat, alphaMode, transform, exifOrientationMode, colorManagementMode)

Public Function GetPixelDataAsync (pixelFormat As BitmapPixelFormat, alphaMode As BitmapAlphaMode, transform As BitmapTransform, exifOrientationMode As ExifOrientationMode, colorManagementMode As ColorManagementMode) As IAsyncOperation(Of PixelDataProvider)