PixelDataProvider.DetachPixelData 方法

定义

命名空间:

Windows.Graphics.Imaging

返回内部存储的像素数据。

public:
 virtual Platform::Array <byte> ^ DetachPixelData() = DetachPixelData;

winrt::array_view <byte> DetachPixelData();

public byte[] DetachPixelData();

function detachPixelData()

Public Function DetachPixelData () As Byte()

返回

Byte[]

byte[]

像素数据。

注解

成功调用此方法后，PixelDataProvider 不会保留像素数据的副本。 这意味着对 方法的后续调用将失败。

如果使用 Windows 运行时 C++ 模板库 (WRL) ，则需负责释放像素数据的基础内存。 处理完数据后，请调用 CoTaskMemFree 。 如果使用 C# 或 C++/WinRT 等语言投影，则会自动处理内存管理。

返回值是包含 8 位无符号值的数组。 但是，根据请求的像素格式，像素数据可能表示另一种类型。 例如，如果像素格式为 Rgba16，则每个颜色值都是一个 16 位无符号整数，该整数占用数组的两个 8 位元素。 必须先将数组转换为正确的类型，然后才能使用它。