GetWinMetaFileBits-Funktion (wingdi.h)

Die GetWinMetaFileBits-Funktion konvertiert die Datensätze im erweiterten Format aus einer Metadatei in Datensätze im Windows-Format und speichert die konvertierten Datensätze im angegebenen Puffer.

Syntax

UINT GetWinMetaFileBits(
  [in]  HENHMETAFILE hemf,
  [in]  UINT         cbData16,
  [out] LPBYTE       pData16,
  [in]  INT          iMapMode,
  [in]  HDC          hdcRef
);

Parameter

[in] hemf

Ein Handle für die erweiterte Metadatei.

[in] cbData16

Die Größe des Puffers in Bytes, in den die konvertierten Datensätze kopiert werden sollen.

[out] pData16

Ein Zeiger auf den Puffer, der die konvertierten Datensätze empfängt. Wenn lpbBufferNULL ist, gibt GetWinMetaFileBits die Anzahl der Bytes zurück, die zum Speichern der konvertierten Metadateidatensätze erforderlich sind.

[in] iMapMode

Der Zuordnungsmodus, der in der konvertierten Metadatei verwendet werden soll.

[in] hdcRef

Ein Handle für den Kontext des Referenzgeräts.

Rückgabewert

Wenn die Funktion erfolgreich ist und der Pufferzeiger NULL ist, ist der Rückgabewert die Anzahl der Bytes, die zum Speichern der konvertierten Datensätze erforderlich sind. Wenn die Funktion erfolgreich ist und der Pufferzeiger ein gültiger Zeiger ist, entspricht der Rückgabewert der Größe der Metadatendaten in Bytes.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Diese Funktion konvertiert eine erweiterte Metadatei in eine Metadatei im Windows-Format, damit das Bild in einer Anwendung angezeigt werden kann, die das ältere Format erkennt.

Das System verwendet den Kontext des Referenzgeräts, um die Auflösung der konvertierten Metadatei zu bestimmen.

Die GetWinMetaFileBits-Funktion ungültig das erweiterte Metadateihandle nicht. Eine Anwendung sollte die DeleteEnhMetaFile-Funktion aufrufen, um das Handle freizugeben, wenn es nicht mehr benötigt wird.

Um eine skalierbare Metadatei im Windows-Format zu erstellen, geben Sie MM_ANISOTROPIC als fnMapMode-Parameter an.

Die obere linke Ecke des Metadateibilds ist immer dem Ursprung des Referenzgeräts zugeordnet.

Anforderungen

Weitere Informationen

DeleteEnhMetaFile

Metafilefunktionen

Übersicht über Metadateien

SetMapMode

SetWinMetaFileBits