IWICBitmapCodecInfo::GetDeviceModels-Methode (wincodec.h)

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