IWICBitmapDecoderInfo::GetPatterns-Methode (wincodec.h)

Ruft die vom Decoder unterstützten Dateimustersignaturen ab.

Syntax

HRESULT GetPatterns(
  [in]  UINT             cbSizePatterns,
  [out] WICBitmapPattern *pPatterns,
  [out] UINT             *pcPatterns,
  [out] UINT             *pcbPatternsActual
);

Parameter

[in] cbSizePatterns

Typ: UINT

Die Arraygröße des pPatterns-Arrays .

[out] pPatterns

Typ: WICBitmapPattern*

Empfängt eine Liste der WICBitmapPattern-Objekte , die vom Decoder unterstützt werden.

[out] pcPatterns

Typ: UINT*

Empfängt die Anzahl von Mustern, die der Decoder unterstützt.

[out] pcbPatternsActual

Typ: UINT*

Empfängt die tatsächliche Puffergröße, die zum Abrufen aller vom Decoder unterstützten Mustersignaturen erforderlich ist.

Rückgabewert

Typ: HRESULT

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

Hinweise

Um alle Mustersignaturen abzurufen, sollte diese Methode zuerst aufgerufen werden, wobei pPatterns auf NULL festgelegt ist, um die tatsächliche Puffergröße abzurufen, die über pcbPatternsActual benötigt wird. Sobald die erforderliche Puffergröße bekannt ist, ordnen Sie einen Puffer der erforderlichen Größe zu, und rufen Sie GetPatterns erneut mit dem zugeordneten Puffer auf.

Anforderungen