PDD_SURFCB_UPDATEOVERLAY Rückruffunktion (ddrawint.h)

Artikel
08/23/2023

Die DdUpdateOverlay-Rückruffunktion positioniert oder ändert die visuellen Attribute einer Überlagerungsoberfläche.

Syntax

PDD_SURFCB_UPDATEOVERLAY PddSurfcbUpdateoverlay;

DWORD PddSurfcbUpdateoverlay(
  PDD_UPDATEOVERLAYDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

Verweist auf eine DD_UPDATEOVERLAYDATA Struktur, die die zum Aktualisieren der Überlagerung erforderlichen Informationen enthält.

Rückgabewert

DdUpdateOverlay gibt einen der folgenden Rückrufcodes zurück:

Hinweise

DdUpdateOverlay zeigt eine Überlagerungsoberfläche auf dem Bildschirm an, blendet sie aus oder positioniert sie neu. Außerdem werden Attribute der Überlagerungsfläche festgelegt, z. B. der Stretchfaktor oder der Typ des zu verwendenden Farbschlüssels.

Der Treiber sollte bestimmen, ob er über die Bandbreite verfügt, um die Überlagerungsupdateanforderung zu unterstützen. Der Treiber sollte den dwFlags-Member der DD_UPDATEOVERLAYDATA-Struktur bei lpUpdateOverlay verwenden, um den Typ der Anforderung und deren Verarbeitung zu bestimmen.

Der Treiber/die Hardware muss die Überlagerung entsprechend strecken oder verkleinern, wenn die von den rDest - und rSrc-Membern von DD_UPDATEOVERLAYDATA angegebenen Rechtecke unterschiedliche Größen aufweisen.

Beachten Sie, dass DdFlip zum Umblättern zwischen Überlagerungsflächen verwendet wird, sodass die Leistung für DdUpdateOverlay nicht entscheidend ist.