IWICBitmapCodecInfo::GetFileExtensions-Methode (wincodec.h)

Artikel
03/03/2024

Ruft eine durch Kommas getrennte Liste der Dateinamenerweiterungen ab, die dem Codec zugeordnet sind.

Syntax

HRESULT GetFileExtensions(
  [in]      UINT  cchFileExtensions,
  [in, out] WCHAR *wzFileExtensions,
  [in, out] UINT  *pcchActual
);

Parameter

[in] cchFileExtensions

Typ: UINT

Die Größe des Dateinamenerweiterungspuffers. Verwenden Sie 0 beim ersten Aufruf, um die erforderliche Puffergröße zu ermitteln.

[in, out] wzFileExtensions

Typ: WCHAR*

Empfängt eine durch Kommas getrennte Liste von Dateinamenerweiterungen, die dem Codec zugeordnet sind. Verwenden Sie NULL beim ersten Aufruf, um die erforderliche Puffergröße zu ermitteln.

[in, out] pcchActual

Typ: UINT*

Die tatsächliche Puffergröße, die zum Abrufen aller dem Codec zugeordneten Dateinamenerweiterungen erforderlich ist.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die Standarderweiterung für einen Bildencoder ist das erste Element in der Liste der zurückgegebenen Erweiterungen.

Das Verwendungsmuster für diese Methode ist ein Zwei-Aufrufprozess. Der erste Aufruf ruft die Puffergröße ab, die zum Abrufen der vollständigen Versionsnummer der Farbverwaltung erforderlich ist, indem er sie aufruft, wobei cchFileExtensions auf 0 und wzFileExtensions auf NULLfestgelegt ist. Dieser Aufruf legt pcchActual auf die erforderliche Puffergröße fest. Sobald die erforderliche Puffergröße ermittelt wurde, ruft ein zweiter GetFileExtensions-Aufruf mit cchFileExtensions auf die Puffergröße und wzFileExtensions auf einen Puffer der entsprechenden Größe festgelegt die Pixelformate ab.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincodec.h
Bibliothek	Windowscodecs.lib

Freigeben über