PDD_VPORTCB_COLORCONTROL Rückruffunktion (ddrawint.h)

Artikel
02/26/2024

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.