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 位元素。 您必須先將陣列轉換成正確的類型，才能使用它。