Função DrvSaveScreenBits (winddi.h)

A função DrvSaveScreenBits faz com que um driver de exibição salve ou restaure um determinado retângulo da imagem exibida.

Sintaxe

ULONG_PTR DrvSaveScreenBits(
  SURFOBJ   *pso,
  ULONG     iMode,
  ULONG_PTR ident,
  RECTL     *prcl
);

Parâmetros

pso

Ponteiro para uma estrutura SURFOBJ que descreve a superfície.

iMode

Especifica a operação a ser executada. Esse parâmetro pode usar um dos valores a seguir:

SS_SAVE

O driver deve salvar os dados do retângulo definido por prcl. O driver é responsável por gerenciar esses dados em sua memória fora da tela. O parâmetro ident é ignorado.

Após o sucesso, DrvSaveScreenBits deve retornar um identificador para os dados salvos. O driver pode retornar um identificador ou até mesmo um ponteiro para sua memória fora da tela. Essa função retornará zero se falhar.

SS_RESTORE

O driver deve restaurar os dados identificados por ident para a prcl retângulo na tela; ou seja, o driver deve restaurar o bitmap para sua posição original. O driver pode assumir que o retângulo em prcl tem exatamente o mesmo tamanho que o retângulo que foi salvo. Os dados devem ser descartados após essa chamada.

DrvSaveScreenBits deverá retornar TRUE se os dados tiverem sido restaurados para a exibição ou FALSE se os dados não puderem ser restaurados.

SS_FREE

Os dados identificados pelo ident não são mais necessários e podem ser liberados. O valor de prcl é indefinido e não deve ser usado. O driver não deve restaurar o retângulo salvo para a exibição.

DrvSaveScreenBits deve retornar TRUE.

ident

Ponteiro para um valor definido pelo driver que foi retornado por uma chamada anterior para DrvSaveScreenBits se iMode for SS_RESTORE ou SS_FREE. O driver deve ignorar esse parâmetro quando iMode for SS_SAVE.

prcl

Ponteiro para uma estrutura RECTL que define a parte da tela a ser salva ou restaurada.

Retornar valor

O valor retornado depende do valor do parâmetro iMode .

Comentários

Alguns drivers de exibição podem ser capazes de mover dados de ou para a memória do dispositivo fora da tela muito mais rápido do que a área pode ser redesenhada. Isso pode ser útil quando o Gerenciador de Janelas deve exibir um menu ou caixa de diálogo.

DrvSaveScreenBits é opcional para drivers de exibição.

Requisitos

Confira também

SURFOBJ