PDD_VPORTCB_COLORCONTROL função de retorno de chamada (ddrawint.h)

Artigo
02/26/2024

A função de retorno de chamada DdVideoPortColorControl obtém ou define os controles de cor do objeto VPE.

Sintaxe

PDD_VPORTCB_COLORCONTROL PddVportcbColorcontrol;

DWORD PddVportcbColorcontrol(
  PDD_VPORTCOLORDATA unnamedParam1
)
{...}

Parâmetros

unnamedParam1

Aponta para uma estrutura DD_VPORTCOLORDATA que contém as informações necessárias para o driver obter os controles de cor do objeto VPE atuais ou definir novos valores.

Retornar valor

DdVideoPortColorControl retorna um dos seguintes códigos de retorno de chamada:

Comentários

Os drivers DirectDraw que definem o sinalizador DDVPCAPS_COLORCONTROL na estrutura DDVIDEOPORTCAPS devem implementar DdVideoPortColorControl.

Dependendo do valor do membro dwFlags da estrutura DD_VPORTCOLORDATA em lpColorControl, o driver deve fazer o seguinte:

Quando dwFlags é DDRAWI_VPORTGETCOLOR, o driver deve preencher cada membro da estrutura DDCOLORCONTROL compatível com a configuração de controle de cor atual do objeto VPE. O driver deve definir o bit correspondente no membro dwFlags de DDCOLORCONTROL para cada membro de controle de cor no qual ele grava dados.
DdVideoPortColorControl pode ser chamado para determinar os recursos de controle de cores do objeto VPE. Portanto, o driver deverá falhar na chamada se não der suporte a uma funcionalidade de controle de cores solicitada.
Quando dwFlags é DDRAWI_VPORTSETCOLOR, o driver deve definir as configurações de controle de cor do objeto VPE para os valores especificados na estrutura DDCOLORCONTROL. O driver deve marcar o membro dwFlags de DDCOLORCONTROL para determinar quais membros da estrutura contêm dados válidos.