Funzione DrvSaveScreenBits (winddi.h)

La funzione DrvSaveScreenBits causa il salvataggio o il ripristino di un determinato rettangolo dell'immagine visualizzata.

Sintassi

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

Parametri

pso

Puntatore a una struttura SURFOBJ che descrive la superficie.

iMode

Specifica l'operazione da eseguire. Questo parametro può essere uno dei valori seguenti:

SS_SAVE

Il driver deve salvare i dati dal rettangolo definito da prcl. Il driver è responsabile della gestione di questi dati nella memoria fuori schermo. Il parametro ident viene ignorato.

Al termine dell'operazione, DrvSaveScreenBits deve restituire un identificatore per i dati salvati. Il driver può restituire un handle o anche un puntatore alla memoria fuori schermo. Questa funzione restituisce zero se ha esito negativo.

SS_RESTORE

Il driver deve ripristinare i dati identificati dal rientro al rettangolo prcl sulla visualizzazione; ovvero, il driver deve ripristinare la bitmap nella posizione originale. Il driver può presumere che il rettangolo in base a prcl sia esattamente la stessa dimensione del rettangolo salvato. I dati devono essere eliminati dopo questa chiamata.

DrvSaveScreenBits deve restituire TRUE se i dati sono stati ripristinati nella visualizzazione o FALSE se i dati non possono essere ripristinati.

SS_FREE

I dati identificati da ident non sono più necessari e possono essere liberati. Il valore di prcl non è definito e non deve essere usato. Il driver non deve ripristinare il rettangolo salvato nella visualizzazione.

DrvSaveScreenBits deve restituire TRUE.

ident

Puntatore a un valore definito dal driver restituito da una chiamata precedente a DrvSaveScreenBits se iMode è SS_RESTORE o SS_FREE. Il driver deve ignorare questo parametro quando iMode è SS_SAVE.

prcl

Puntatore a una struttura RECTL che definisce la parte dello schermo da salvare o ripristinare.

Valore restituito

Il valore restituito dipende dal valore del parametro iMode .

Commenti

Alcuni driver di visualizzazione potrebbero essere in grado di spostare i dati in o dalla memoria del dispositivo fuori schermo molto più veloce rispetto all'area può essere ridisegnata. Ciò potrebbe risultare utile quando Window Manager deve visualizzare un menu o una finestra di dialogo.

DrvSaveScreenBits è facoltativo per i driver di visualizzazione.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione winddi.h (include Winddi.h)

Vedi anche

SURFOBJ