Função DdGetDC (ddrawgdi.h)

  • Artigo

[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

Confira também

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