Share via

Função DdCreateDirectDrawObject (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 NtGdiDdCreateDirectDrawObject e cria uma representação do lado do kernel do objeto Microsoft DirectDraw. Um identificador para essa representação será armazenado em pDirectDrawGlobal-hDD>.

GdiEntry1 é definido como um alias para essa função.

Sintaxe

BOOL DdCreateDirectDrawObject(
  LPDDRAWI_DIRECTDRAW_GBL pDirectDrawGlobal,
  HDC                     hdc
);

Parâmetros

pDirectDrawGlobal

Ponteiro para o objeto DirectDraw no modo de usuário. Confira a documentação do DDK para obter detalhes.

hdc

Manipule para o DC para o dispositivo para o qual essa representação é criada. Se 0, o dispositivo será o dispositivo "display". Observe que essa função retém apenas um objeto DirectDraw "display" e retornará um identificador copiado para esse mesmo objeto se, posteriormente, chamado com hdc = 0.

Retornar valor

Se tiver êxito, essa função retornará TRUE; caso contrário, retornará FALSE.

Comentários

Os aplicativos são aconselhados a usar as APIs DirectDraw e Direct3D para criar e gerenciar objetos de dispositivo gráfico. Esses constructos abstraem o processo de criação do dispositivo de maneira simplificada e 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]
Plataforma de Destino Windows
Cabeçalho ddrawgdi.h

Confira também

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