Função NtGdiDdGetDC

  • Artigo

[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.]

Cria um DC (contexto de dispositivo) para a superfície especificada.

Sintaxe

HDC APIENTRY NtGdiDdGetDC(
  _In_ HANDLE       hSurface,
  _In_ PALETTEENTRY *puColorTable
);

Parâmetros

hSurface [in]

Identificador para uma superfície DirectDraw no modo kernel retornada anteriormente por NtGdiDdCreateSurface ou NtGdiDdCreateSurfaceObject.

puColorTable [in]

Ponteiro para uma tabela de cores de substituição para o DC retornado.

Valor retornado

Se tiver êxito, essa função retornará um HDC válido; caso contrário, retornará NULL.

Comentários

Somente um DC é permitido por superfície a qualquer momento. As chamadas subsequentes para NtGdiDdGetDC falharão até que o DC anterior seja liberado.

Os aplicativos são aconselhados a chamar IDirectDrawSurface7::GetDC , que fornece a mesma funcionalidade de maneira independente do sistema operacional.

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
Ntgdi.h

Confira também

Suporte ao cliente de baixo nível de gráficos

DdGetDC