IWICBitmapCodecInfo::GetDeviceModels-Methode (wincodec.h)

Artikel
08/27/2023

Ruft eine durch Kommas getrennte Liste der Gerätemodelle ab, die dem Codec zugeordnet sind.

Syntax

HRESULT GetDeviceModels(
  [in]      UINT  cchDeviceModels,
  [in, out] WCHAR *wzDeviceModels,
  [in, out] UINT  *pcchActual
);

Parameter

[in] cchDeviceModels

Typ: UINT

Die Größe des Puffers für Gerätemodelle. Verwenden Sie 0 beim ersten Aufruf, um die erforderliche Puffergröße zu ermitteln.

[in, out] wzDeviceModels

Typ: WCHAR*

Empfängt eine durch Kommas getrennte Liste von Gerätemodellnamen, 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 Gerätemodellnamen erforderlich ist.

Rückgabewert

Typ: HRESULT

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

Hinweise

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 cchDeviceModels auf 0 und wzDeviceModels auf NULLfestgelegt ist. Dieser Aufruf legt pcchActual auf die erforderliche Puffergröße fest. Sobald die erforderliche Puffergröße ermittelt wurde, ruft ein zweiter GetDeviceModels-Aufrufmit cchDeviceModels auf die Puffergröße und wzDeviceModels auf einen Puffer der entsprechenden Größe festgelegt die Pixelformate ab.

Anforderungen


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
DLL	Windowscodecs.dll

Freigeben über