Freigeben über


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)

Weitere Informationen

SURFOBJ