PixelDataProvider.DetachPixelData メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
内部に格納されているピクセル データを返します。
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 ビット符号なし整数になります。 使用する前に、配列を正しい型に変換する必要があります。