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) |