Função DrvDeriveSurface (winddi.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | winddi.h (inclua Winddi.h) |