PixelDataProvider.DetachPixelData Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.