PDD_VPORTCB_COLORCONTROL funzione di callback (ddrawint.h)

Articolo
02/29/2024

La funzione di callback DdVideoPortColorControl ottiene o imposta i controlli colore oggetto VPE.

Sintassi

PDD_VPORTCB_COLORCONTROL PddVportcbColorcontrol;

DWORD PddVportcbColorcontrol(
  PDD_VPORTCOLORDATA unnamedParam1
)
{...}

Parametri

unnamedParam1

Punta a una struttura DD_VPORTCOLORDATA che contiene le informazioni necessarie per il driver per ottenere i controlli colore oggetto VPE correnti o per impostare nuovi valori.

Valore restituito

DdVideoPortColorControl restituisce uno dei codici di callback seguenti:

Commenti

I driver DirectDraw che impostano il flag DDVPCAPS_COLORCONTROL nella struttura DDVIDEOPORTCAPS devono implementare DdVideoPortColorControl.

A seconda del valore del membro dwFlags della struttura DD_VPORTCOLORDATA in lpColorControl, il driver deve eseguire le operazioni seguenti:

Quando dwFlags è DDRAWI_VPORTGETCOLOR, il driver deve compilare ogni membro della struttura DDCOLORCONTROL supportata con l'impostazione del controllo colore corrente dell'oggetto VPE. Il driver deve impostare il bit corrispondente nel membro dwFlags di DDCOLORCONTROL per ogni membro del controllo colore in cui scrive i dati.
DdVideoPortColorControl può essere chiamato per determinare le funzionalità di controllo colore dell'oggetto VPE. Il driver deve quindi non riuscire la chiamata se non supporta una funzionalità di controllo colori richiesta.
Quando dwFlags è DDRAWI_VPORTSETCOLOR, il driver deve impostare le impostazioni del controllo colore dell'oggetto VPE sui valori specificati nella struttura DDCOLORCONTROL. Il driver deve controllare il membro dwFlags di DDCOLORCONTROL per determinare quali membri della struttura contengono dati validi.