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 の場合、各色の値は、配列の 2 つの 8 ビット要素を占める 16 ビット符号なし整数になります。 使用する前に、配列を正しい型に変換する必要があります。