PDD_VPORTCB_COLORCONTROL Rückruffunktion (ddrawint.h)
Die DdVideoPortColorControl-Rückruffunktion ruft die VPE-Objektfarbsteuerelemente ab oder legt diese fest.
Syntax
PDD_VPORTCB_COLORCONTROL PddVportcbColorcontrol;
DWORD PddVportcbColorcontrol(
PDD_VPORTCOLORDATA unnamedParam1
)
{...}
Parameter
unnamedParam1
Verweist auf eine DD_VPORTCOLORDATA-Struktur , die die Informationen enthält, die der Treiber zum Abrufen der aktuellen VPE-Objektfarbsteuerelemente oder zum Festlegen neuer Werte benötigt.
Rückgabewert
DdVideoPortColorControl gibt einen der folgenden Rückrufcodes zurück:
Hinweise
DirectDraw-Treiber, die das DDVPCAPS_COLORCONTROL-Flag in der DDVIDEOPORTCAPS-Struktur festlegen, müssen DdVideoPortColorControl implementieren.
Abhängig vom Wert des dwFlags-Members der DD_VPORTCOLORDATA-Struktur bei lpColorControl sollte der Treiber die folgenden Schritte ausführen:
-
Wenn dwFlags DDRAWI_VPORTGETCOLOR ist, sollte der Treiber jedes Element der DDCOLORCONTROL-Struktur ausfüllen, das er mit der aktuellen Farbsteuerungseinstellung des VPE-Objekts unterstützt. Der Treiber muss das entsprechende Bit im dwFlags-Member von DDCOLORCONTROL für jedes Farbsteuerelementelement festlegen, in das er Daten schreibt.
DdVideoPortColorControl kann aufgerufen werden, um die Farbsteuerungsfunktionen des VPE-Objekts zu bestimmen. Der Treiber sollte daher beim Aufruf fehlschlagen, wenn er eine angeforderte Farbsteuerungsfunktion nicht unterstützt.
- Wenn dwFlags DDRAWI_VPORTSETCOLOR ist, sollte der Treiber die Farbsteuerungseinstellungen des VPE-Objekts auf die werte festlegen, die in der DDCOLORCONTROL-Struktur angegeben sind. Der Treiber sollte den dwFlags-Member von DDCOLORCONTROL überprüfen, um zu ermitteln, welche Strukturmitglieder gültige Daten enthalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | ddrawint.h (include Winddi.h) |