IWICBitmapSource::GetResolution-Methode (wincodec.h)

  • Artikel

Ruft die Samplingrate zwischen Pixeln und physischen Weltmessungen ab.

Syntax

HRESULT GetResolution(
  [out] double *pDpiX,
  [out] double *pDpiY
);

Parameter

[out] pDpiX

Typ: double*

Ein Zeiger, der die dpi-Auflösung der x-Achse empfängt.

[out] pDpiY

Typ: double*

Ein Zeiger, der die dpi-Auflösung der y-Achse empfängt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Einige Formate, z. B. GIF und ICO, verfügen nicht über vollständige DPI-Unterstützung. Für GIF berechnet diese Methode die DPI-Werte aus dem Seitenverhältnis unter Verwendung eines Basis-DPI von (96,0, 96,0). Das ICO-Format unterstützt überhaupt nicht DPI, und die Methode gibt für ICO-Bilder immer (96.0,96.0) zurück.

Darüber hinaus transformiert WIC selbst keine Bilder basierend auf den DPI-Werten in einem Bild. Es liegt am Aufrufer, ein Bild basierend auf der zurückgegebenen Auflösung zu transformieren.

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