IWICBitmapFrameDecode::GetColorContexts-Methode (wincodec.h)

Ruft den IWICColorContext ab, der dem Bildrahmen zugeordnet ist.

Syntax

HRESULT GetColorContexts(
  [in]      UINT             cCount,
  [in, out] IWICColorContext **ppIColorContexts,
  [out]     UINT             *pcActualCount
);

Parameter

[in] cCount

Typ: UINT

Die Anzahl der abzurufenden Farbkontexte.

Dieser Wert muss die Größe oder kleiner als die für ppIColorContexts verfügbare Größe sein.

[in, out] ppIColorContexts

Typ: IWICColorContext**

Ein Zeiger, der einen Zeiger auf die IWICColorContext-Objekte empfängt.

[out] pcActualCount

Typ: UINT*

Ein Zeiger, der die Anzahl von Farbkontexten empfängt, die im Bildrahmen enthalten sind.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn NULL für ppIColorContexts und 0 für cCount übergeben wird, gibt diese Methode die Gesamtanzahl von Farbkontexten im Bild in pcActualCount zurück.

Das ppIColorContexts-Array muss mit gültigen Daten gefüllt werden: Jedes IWICColorContext* im Array muss mit IWICImagingFactory::CreateColorContext erstellt worden sein.

Anforderungen