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
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |