CMTranslateRGBsExt-Funktion (icm.h)

Artikel
08/24/2023

Übersetzt eine Bitmap aus einem definierten Format in ein anderes definiertes Format und ruft in regelmäßigen Abständen eine Rückruffunktion auf, sofern angegeben, um den Fortschritt zu melden und der aufrufenden Anwendung das Beenden der Übersetzung zu ermöglichen.

Syntax

BOOL CMTranslateRGBsExt(
  HCMTRANSFORM   hcmTransform,
  LPVOID         lpSrcBits,
  BMFORMAT       bmInput,
  DWORD          dwWidth,
  DWORD          dwHeight,
  DWORD          dwInputStride,
  LPVOID         lpDestBits,
  BMFORMAT       bmOutput,
  DWORD          dwOutputStride,
  LPBMCALLBACKFN lpfnCallback,
  LPARAM         ulCallbackData
);

Parameter

hcmTransform

Gibt die zu verwendende Farbtransformation an.

lpSrcBits

Zeiger auf die zu übersetzende Bitmap.

bmInput

Gibt das Eingabebitbitbitformat an.

dwWidth

Gibt die Anzahl der Pixel pro Scanzeile in der Eingabebitbitte an.

dwHeight

Gibt die Anzahl der Scanzeilen in der Eingabebitbitbit an.

dwInputStride

Gibt die Anzahl der Bytes vom Anfang einer Scanzeile bis zum Anfang der nächsten in der Eingabebitbitte an. Wenn dwInputStride auf 0 festgelegt ist, sollte der CMM davon ausgehen, dass Scanzeilen aufgefüllt sind, um DWORD-ausgerichtet zu sein.

lpDestBits

Verweist auf einen Zielpuffer, in dem die übersetzte Bitmap platziert werden soll.

bmOutput

Gibt das Ausgabebitbitbitformat an.

dwOutputStride

Gibt die Anzahl der Bytes vom Anfang einer Scanzeile bis zum Anfang der nächsten in der Eingabebitbitte an. Wenn dwOutputStride auf 0 festgelegt ist, sollte der CMM Scanzeilen so auffüllen, dass sie DWORD-ausgerichtet sind.

lpfnCallback

Zeiger auf eine von der Anwendung bereitgestellte Rückruffunktion, die regelmäßig von CMTranslateRGBsExt aufgerufen wird, um den Fortschritt zu melden und dem aufrufenden Prozess das Abbrechen der Übersetzung zu ermöglichen. (Siehe ICMProgressProcCallback.)

ulCallbackData

Daten, die an die Rückruffunktion zurückgegeben werden, z. B. zur Identifizierung der Übersetzung, die den Fortschritt meldet.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE , und der CMM sollte SetLastError aufrufen, um den letzten Fehler auf einen in Winerror.h definierten gültigen Fehlerwert festzulegen.

Hinweise

Jeder CMM ist erforderlich, um diese Funktion zu exportieren.

Beim Schreiben in den Zielpuffer sollte der CMM sicherstellen, dass Scanzeilen aufgefüllt werden, um DWORD-ausgerichtet zu sein.

Wenn die Eingabe- und Ausgabeformate nicht mit der Farbtransformation kompatibel sind, schlägt diese Funktion fehl.

Wenn sowohl das Format der Eingabe- als auch die Ausgabebits 3 Kanäle und 4 Bytes pro Pixel aufweisen, wie bei BM_xRGBQUADS, sollten die vierten Bytes beibehalten und in den Ausgabepuffer kopiert werden.

Wenn die Rückruffunktion null zurückgibt, sollte die Verarbeitung abgebrochen werden, und CMTranslateRGBsExt sollte null zurückgeben, um einen Fehler anzuzeigen. Der Ausgabepuffer kann teilweise gefüllt sein.

Beachten Sie, dass diese Funktion die direkte Übersetzung unterstützen muss. Das heißt, wenn der Speicherbedarf der Ausgabe kleiner oder gleich dem Speicherbedarf der Eingabe ist, muss diese Funktion in der Lage sein, die Bitmapfarben auch dann zu übersetzen, wenn quell- und zielpuffert sind.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	icm.h

Freigeben über