Função EngCreateDeviceSurface (winddi.h)

A função EngCreateDeviceSurface cria e retorna um identificador para uma superfície de dispositivo que o driver gerenciará.

Sintaxe

ENGAPI HSURF EngCreateDeviceSurface(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

Parâmetros

[in] dhsurf

Identificador de dispositivo para a superfície a ser gerenciada pelo dispositivo. Esse identificador é passado para o driver quando uma estrutura SURFOBJ é passada para entrada ou saída.

[in] sizl

Especifica uma estrutura SIZEL que contém a largura e a altura da superfície a ser criada. Os membros cx e cy dessa estrutura contêm respectivamente, a largura e a altura da superfície, em pixels. Uma estrutura SIZEL é idêntica a uma estrutura SIZE .

iFormatCompat

Especifica o formato do mecanismo compatível da superfície do dispositivo que está sendo criada. Isso será usado pela GDI se um buffer temporário for necessário para simular uma chamada de desenho complicada.

Retornar valor

O valor retornado é um identificador que identifica a superfície se a função for bem-sucedida. Caso contrário, ele será zero e um código de erro será registrado.

Comentários

Opcionalmente, o espaço de armazenamento para a superfície pode ser fornecido pelo driver. A superfície deve ser associada usando EngAssociateSurface. A superfície deve ser excluída quando não for mais necessária usando EngDeleteSurface.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Universal
Cabeçalho	winddi.h (inclua Winddi.h)
Biblioteca	Win32k.lib
DLL	Win32k.sys

Confira também

EngAssociateSurface

EngDeleteSurface

SURFOBJ