PDD_VPORTCB_COLORCONTROL fonction de rappel (ddrawint.h)

Article
02/26/2024

La fonction de rappel DdVideoPortColorControl obtient ou définit les contrôles de couleur d’objet VPE.

Syntaxe

PDD_VPORTCB_COLORCONTROL PddVportcbColorcontrol;

DWORD PddVportcbColorcontrol(
  PDD_VPORTCOLORDATA unnamedParam1
)
{...}

Paramètres

unnamedParam1

Pointe vers une structure DD_VPORTCOLORDATA qui contient les informations nécessaires au pilote pour obtenir les contrôles de couleur d’objet VPE actuels ou pour définir de nouvelles valeurs.

Valeur retournée

DdVideoPortColorControl retourne l’un des codes de rappel suivants :

Remarques

Les pilotes DirectDraw qui définissent l’indicateur DDVPCAPS_COLORCONTROL dans la structure DDVIDEOPORTCAPS doivent implémenter DdVideoPortColorControl.

Selon la valeur du membre dwFlags de la structure DD_VPORTCOLORDATA sur lpColorControl, le pilote doit effectuer les opérations suivantes :

Lorsque dwFlags est DDRAWI_VPORTGETCOLOR, le pilote doit renseigner chaque membre de la structure DDCOLORCONTROL qu’il prend en charge avec le paramètre de contrôle de couleur actuel de l’objet VPE. Le pilote doit définir le bit correspondant dans le membre dwFlags de DDCOLORCONTROL pour chaque membre de contrôle de couleur dans lequel il écrit des données.
DdVideoPortColorControl peut être appelé pour déterminer les fonctionnalités de contrôle de couleur de l’objet VPE. Le pilote doit donc échouer l’appel s’il ne prend pas en charge une fonctionnalité de contrôle de couleur demandée.
Lorsque dwFlags est DDRAWI_VPORTSETCOLOR, le pilote doit définir les paramètres de contrôle de couleur de l’objet VPE sur les valeurs spécifiées dans la structure DDCOLORCONTROL. Le pilote doit case activée le membre dwFlags de DDCOLORCONTROL pour déterminer quels membres de structure contiennent des données valides.