Share via

Função DdCreateSurfaceObject (ddrawgdi.h)

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

Wrapper para a função NtGdiDdCreateSurfaceObject e cria um objeto de superfície no modo kernel.

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

Sintaxe

BOOL DdCreateSurfaceObject(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
  BOOL                      bPrimarySurface
);

Parâmetros

pSurfaceLocal

Ponteiro para o objeto de superfície do modo de usuário. Consulte a documentação do DDK para obter detalhes. Um identificador para o objeto do modo kernel é colocado em pSurfaceLocal-hDDSurface>.

bPrimarySurface

Reservado.

Valor retornado

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

Comentários

Essa função é usada para criar objetos que representam superfícies de memória do sistema. As superfícies de memória de vídeo recebem uma representação no modo kernel como uma parte implícita da chamada NtGdiDdCreateSurfaceObject .

Os aplicativos são aconselhados a usar as APIs DirectDraw e Direct3D para criar e gerenciar objetos de dispositivo gráfico. Essas construções abstraem o processo de criação do dispositivo de maneira simplificada e independente do sistema operacional.

Requisitos

   
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