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 |