Die Funktion LoadDIBFromFile lädt eine .BMP Bitmap-Datei in den Hauptspeicher und liefert ein HDIB-Handle zurück.
HDIB API LoadDIBFromFile ( |
||
szFile, |
||
HDIB |
hDIB); |
szFile |
Zeiger auf den Dateinamen unter dem die Datei gespeichert werden soll. |
|
Rückgabewert |
||
Ein HDIB-Handle das die eingelesenen Dateidaten kennzeichnet. NULL, falls die Funktion nicht erfolgreich war. Wahrscheinlichste Ursachen: |
• |
die Datei mit dem angegebenen Namen wurde nicht gefunden, |
• |
nicht genügend freier Hauptspeicher, |
• |
das Dateiformat der Datei ist keine Windows BMP-Datei (BITMAPFILEHEADER). |
Anmerkungen |
|
Falls die DIB in der BMP-Datei RLE-Kodiert gespeichert wurde (Einfaches Kompressionsverfahren, biCompression=BI_RLE4 oder BI_RLE8) wandelt LoadDIBFromFile sie automatisch in ein unkomprimiertes Format um. |
|
Top-Down DIBs (biHeight < 0) werden automatisch in Bottom-Up DIBs umgewandelt. |
|