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)