Share via


PixelDataProvider.DetachPixelData Methode

Definition

Gibt die intern gespeicherten Pixeldaten zurück.

public:
 virtual Platform::Array <byte> ^ DetachPixelData() = DetachPixelData;
winrt::array_view <byte> DetachPixelData();
public byte[] DetachPixelData();
function detachPixelData()
Public Function DetachPixelData () As Byte()

Gibt zurück

Byte[]

byte[]

Die Pixeldaten.

Hinweise

PixelDataProvider behält nach einem erfolgreichen Aufruf dieser Methode keine Kopie der Pixeldaten bei. Dies bedeutet, dass nachfolgende Aufrufe der -Methode fehlschlagen.

Wenn Sie die Windows-Runtime C++-Vorlagenbibliothek (WRL) verwenden, sind Sie dafür verantwortlich, den zugrunde liegenden Arbeitsspeicher für die Pixeldaten freizugeben. Rufen Sie CoTaskMemFree auf, nachdem Sie mit den Daten fertig sind. Wenn Sie eine Sprachprojektion wie C# oder C++/WinRT verwenden, erfolgt die Speicherverwaltung automatisch.

Der Rückgabewert ist ein Array von 8-Bit-Werten ohne Vorzeichen. Abhängig vom angeforderten Pixelformat können die Pixeldaten jedoch einen anderen Typ darstellen. Wenn das Pixelformat beispielsweise Rgba16 ist, ist jeder Farbwert eine 16-Bit-Ganzzahl ohne Vorzeichen, die zwei 8-Bit-Elemente des Arrays akzeptiert. Sie müssen das Array in den richtigen Typ konvertieren, bevor Sie es verwenden.

Gilt für: