Share via


HTUI_DeviceColorAdjustment-Funktion (winddi.h)

Die HTUI_DeviceColorAdjustment-Funktion kann von Grafikgerätetreibern verwendet werden, um ein Dialogfeld anzuzeigen, das es einem Benutzer ermöglicht, die Halbtoningeigenschaften eines Geräts anzupassen.

Syntax

LONG HTUI_DeviceColorAdjustment(
  [in, optional] LPSTR         pDeviceName,
  [in]           PDEVHTADJDATA pDevHTAdjData
);

Parameter

[in, optional] pDeviceName

Vom Aufrufer bereitgestellter Zeiger auf eine NULL-Zeichenfolge, die einen anzeigebaren Gerätenamen darstellt.

[in] pDevHTAdjData

Vom Aufrufer bereitgestellter Zeiger auf eine DEVHTADJDATA-Struktur .

Rückgabewert

Die Funktion gibt die folgenden Werte zurück:

Rückgabecode Beschreibung
Größer als 0
Der Benutzer hat die Schaltfläche OK des Dialogfelds ausgewählt.
0
Der Benutzer hat die Schaltfläche Abbrechen des Dialogfelds ausgewählt.
Kleiner als 0
Ein Fehler ist aufgetreten.

Hinweise

Eine Grafiktreiberschnittstelle, z. B. eine Druckerschnittstellen-DLL, kann die HTUI_DeviceColorAdjustment-Funktion aufrufen, um ein Dialogfeld anzuzeigen, das es einem Benutzer ermöglicht, die Halftoningeigenschaften des Geräts anzuzeigen und zu ändern. Abhängig von den für die DEVHTADJDATA-Struktur angegebenen Memberwerten aktiviert die Funktion entweder das Dialogfeld für Benutzeränderungen oder zeigt einfach vom Aufrufer angegebene Standardwerte an. Wenn die Benutzeränderung zulässig ist, gibt die Funktion die geänderten Parameter an den Aufrufer zurück (mithilfe der DEVHTAJDATA-Struktur), sodass der Treiber sie an das Gerät übergeben kann.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile winddi.h (einschließlich Winddi.h)
Bibliothek Win32k.lib
DLL Win32k.sys

Weitere Informationen

DEVHTADJDATA