Função DrvDeriveSurface (winddi.h)

Artigo
03/04/2024

A função DrvDeriveSurface deriva uma superfície GDI da superfície DirectDraw especificada.

Sintaxe

HBITMAP DrvDeriveSurface(
  DD_DIRECTDRAW_GLOBAL *pDirectDraw,
  DD_SURFACE_LOCAL     *pSurface
);

Parâmetros

pDirectDraw

Ponteiro para uma estrutura DD_DIRECTDRAW_GLOBAL que descreve o objeto DirectDraw.

pSurface

Ponteiro para uma estrutura DD_SURFACE_LOCAL que descreve a superfície directdraw em torno da qual encapsular uma superfície GDI.

Retornar valor

DrvDeriveSurface retorna um identificador para a superfície GDI derivada após o sucesso. Ele retornará NULL se a chamada falhar ou se o driver não puder acelerar o desenho de GDI para a superfície do DirectDraw especificada.

Comentários

DrvDeriveSurface permite que o driver crie uma superfície GDI encapsulada em torno de uma memória de vídeo DirectDraw ou um objeto de superfície AGP, a fim de permitir o desenho de GDI acelerado para a superfície. Se o driver não conectar essa chamada, todo o desenho GDI para superfícies DirectDraw será feito no software usando o mecanismo DIB.

A GDI chama DrvDeriveSurface apenas com superfícies RGB.

O driver deve chamar DrvCreateDeviceBitmap para criar uma superfície GDI do mesmo tamanho e formato que a da superfície DirectDraw. O espaço para os pixels reais não precisa ser alocado, pois ele já existe.