DrvSaveScreenBits-Funktion (winddi.h)
Die DrvSaveScreenBits-Funktion bewirkt, dass ein Anzeigetreiber ein bestimmtes Rechteck des angezeigten Bilds speichert oder wiederhergestellt.
Syntax
ULONG_PTR DrvSaveScreenBits(
SURFOBJ *pso,
ULONG iMode,
ULONG_PTR ident,
RECTL *prcl
);
Parameter
pso
Zeiger auf eine SURFOBJ-Struktur , die die Oberfläche beschreibt.
iMode
Gibt den auszuführenden Vorgang an. Dieser Parameter kann einer der folgenden Werte sein:
SS_SAVE
Der Treiber sollte die Daten aus dem durch prcl definierten Rechteck speichern. Der Treiber ist für die Verwaltung dieser Daten im Off-Screen-Arbeitsspeicher verantwortlich. Der ident-Parameter wird ignoriert.
Bei Erfolg sollte DrvSaveScreenBits einen Bezeichner für die gespeicherten Daten zurückgeben. Der Treiber kann ein Handle oder sogar einen Zeiger auf seinen Off-Screen-Speicher zurückgeben. Diese Funktion gibt null zurück, wenn sie fehlschlägt.
SS_RESTORE
Der Treiber sollte die durch ident identifizierten Daten im Rechteck prcl auf dem Display wiederherstellen. Das heißt, der Treiber sollte die Bitmap an ihrer ursprünglichen Position wiederherstellen. Der Treiber kann davon ausgehen, dass das Rechteck bei prcl genau die gleiche Größe wie das gespeicherte Rechteck hat. Die Daten sollten nach diesem Aufruf verworfen werden.
DrvSaveScreenBits sollte TRUE zurückgeben, wenn die Daten auf der Anzeige wiederhergestellt wurden, oder FALSE , wenn die Daten nicht wiederhergestellt werden können.
SS_FREE
Die durch ident identifizierten Daten werden nicht mehr benötigt und können freigegeben werden. Der Wert von prcl ist undefiniert und sollte nicht verwendet werden. Der Treiber sollte das gespeicherte Rechteck nicht auf der Anzeige wiederherstellen.
DrvSaveScreenBits sollte TRUE zurückgeben.
ident
Zeiger auf einen treiberdefinierten Wert, der von einem vorherigen Aufruf von DrvSaveScreenBits zurückgegeben wurde, wenn iMode SS_RESTORE oder SS_FREE ist. Der Treiber sollte diesen Parameter ignorieren, wenn iMode SS_SAVE ist.
prcl
Zeiger auf eine RECTL-Struktur , die den zu speichernden oder wiederherzustellenden Teil des Bildschirms definiert.
Rückgabewert
Der Rückgabewert ist vom Wert des iMode-Parameters abhängig.
Hinweise
Einige Anzeigetreiber sind möglicherweise in der Lage, Daten viel schneller in den oder aus dem Arbeitsspeicher des Offscreen-Geräts zu verschieben, als der Bereich neu gezeichnet werden kann. Dies kann nützlich sein, wenn der Fenster-Manager ein Menü oder Dialogfeld anzeigen muss.
DrvSaveScreenBits ist für Anzeigetreiber optional.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | winddi.h (einschließlich Winddi.h) |