GetEnhMetaFilePixelFormat-Funktion (wingdi.h)
Die GetEnhMetaFilePixelFormat-Funktion ruft Pixelformatinformationen für eine erweiterte Metadatei ab.
Syntax
UINT GetEnhMetaFilePixelFormat(
HENHMETAFILE hemf,
UINT cbBuffer,
PIXELFORMATDESCRIPTOR *ppfd
);
Parameter
hemf
Identifiziert die erweiterte Metadatei.
cbBuffer
Gibt die Größe des Puffers in Bytes an, in den die Pixelformatinformationen kopiert werden.
ppfd
Zeiger auf eine PIXELFORMATDESCRIPTOR-Struktur , die die Spezifikation des logischen Pixelformats enthält. Die Metadatei verwendet diese Struktur, um die Spezifikation des logischen Pixelformats aufzuzeichnen.
Rückgabewert
Wenn die Funktion erfolgreich ist und ein Pixelformat findet, entspricht der Rückgabewert der Größe des Pixelformats der Metadatei.
Wenn kein Pixelformat vorhanden ist, ist der Rückgabewert 0.
Wenn ein Fehler auftritt und die Funktion fehlschlägt, wird der Rückgabewert GDI_ERROR. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Wenn eine erweiterte Metadatei ein Pixelformat in der ENHMETAHEADER-Struktur angibt und das Pixelformat in den Puffer passt, werden die Pixelformatinformationen in ppfd kopiert. Wenn cbBuffer zu klein ist, um das Pixelformat der Metadatei zu enthalten, wird das Pixelformat nicht in den Puffer kopiert. In beiden Fällen gibt die Funktion die Größe des Pixelformats der Metadatei zurück.
Informationen zur Metadateiaufzeichnung und zu anderen Vorgängen finden Sie unter Erweiterte Metadateivorgänge.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |