Função DdGetDC (ddrawgdi.h)
[Essa função está sujeita a alterações com cada revisão do sistema operacional. Em vez disso, use o 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.]
Wrapper para a função NtGdiDdGetDC e retorna um DC (contexto de dispositivo) GDI (Graphics Device Interface) do Windows que representa a superfície do Microsoft DirectDraw indicada.
GdiEntry7 é definido como um alias para essa função.
Sintaxe
HDC DdGetDC(
LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
LPPALETTEENTRY pColorTable
);
Parâmetros
pSurfaceLocal
Ponteiro para a superfície directDraw para a qual um DC é solicitado.
pColorTable
Ponteiro opcional para uma matriz de 256 entradas de estruturas PALETTEENTRY . Se a tabela de cores for nula e a superfície e o modo de exibição forem de 8 bits por pixel, o CONTROLADOR de Domínio compartilhará a tabela de cores do dispositivo.
Retornar valor
Se tiver êxito, essa função retornará um HDC válido; caso contrário, retornará NULL.
Comentários
Se a superfície e o modo de exibição atual forem paletizados a 8 bits por pixel, o DC poderá receber a propriedade especial de que sua tabela de cores é compartilhada pela tabela de cores do dispositivo de exibição. Os aplicativos são aconselhados a chamar IDirectDrawSurface7::GetDC , que fornece a mesma funcionalidade de maneira independente do sistema operacional.
O DC retornado deve ser liberado por uma chamada para NtGdiDdReleaseDC ou GdiEntry8.
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] |
| Plataforma de Destino | Windows |
| Cabeçalho | ddrawgdi.h |