Função NtGdiDdSetColorKey
[Essa função está sujeita a alterações com cada revisão do sistema operacional. Em vez disso, use o Microsoft DirectDraw e o Microsoft Direct3DAPIs; essas APIs isolam os aplicativos dessas alterações do sistema operacional e ocultam muitas outras dificuldades envolvidas na interação diretamente com drivers de exibição.]
Define o valor da chave de cor para a superfície especificada.
Sintaxe
DWORD APIENTRY NtGdiDdSetColorKey(
_In_ HANDLE hSurface,
_Inout_ PDD_SETCOLORKEYDATA puSetColorKeyData
);
Parâmetros
-
hSurface [in]
-
Ponteiro para a estrutura DD_SURFACE_LOCAL que descreve a superfície com a qual a chave de cor deve ser associada.
-
puSetColorKeyData [in, out]
-
Ponteiro para uma estrutura DD_SETCOLORKEYDATA que contém as informações necessárias para definir a chave de cor para a superfície especificada.
Valor retornado
NtGdiDdSetColorKey retorna um dos seguintes códigos de retorno de chamada.
| Código de retorno | Descrição |
|---|---|
|
O driver executou a operação e retornou um código de retorno válido para essa operação. Se esse código for DD_OK, DirectDraw ou Direct3D prosseguirá com a função . Caso contrário, DirectDraw ou Direct3D retornará o código de erro fornecido pelo driver e anulará a função. |
|
O driver não tem comentários sobre a operação solicitada. Se o driver for necessário para ter implementado um retorno de chamada específico, DirectDraw ou Direct3D relatará uma condição de erro. Caso contrário, DirectDraw ou Direct3D manipula a operação como se o retorno de chamada do driver não tivesse sido definido executando a implementação independente do dispositivo DirectDraw ou Direct3D. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
Confira também