Função NtGdiDdGetDC
[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 |
|
Confira também