DrvSynchronize-Funktion (winddi.h)

Artikel
03/04/2024

Die DrvSynchronize-Funktion informiert den Treiber darüber, dass GDI auf eine geräteverwaltete Oberfläche zugreifen muss. Mit dieser Funktion können asynchrone Zeichnungsvorgänge, die vom Coprozessor eines Geräts ausgeführt werden, mit GDI-Zugriffen koordiniert werden.

Syntax

void DrvSynchronize(
  DHPDEV dhpdev,
  RECTL  *prcl
);

Parameter

dhpdev

Verarbeiten Sie die PDEV-Struktur des physischen Geräts, die das gerät identifiziert, das mit GDI synchronisiert werden soll. Dieser Parameter ist das Gerätehandle, das von DrvEnablePDEV an GDI zurückgegeben wird.

prcl

Zeiger auf eine RECTL-Struktur . Dieser Parameter sollte vom Treiber ignoriert werden.

Rückgabewert

Keine

Bemerkungen

Mit dieser Funktion können asynchrone Zeichnungsvorgänge, die vom Coprozessor eines Geräts ausgeführt werden, mit GDI-Zugriffen koordiniert werden.

DrvSynchronize kann optional in Anzeigetreibern implementiert werden. GDI ruft diese Funktion nur auf, wenn sie von EngAssociateSurface eingebunden ist. GDI ruft DrvSynchronize direkt vor dem Zeichnen direkt auf die Geräteoberfläche auf. GDI ruft DrvSynchronizeSurface anstelle von DrvSynchronize in Treibern auf, die beide Funktionen implementieren.

Diese Funktion sollte nur zurückgegeben werden, wenn GDI sicher auf eine vom Gerät verwaltete Oberfläche zugreifen kann. Das heißt, DrvSynchronize sollte die Rückgabe vom Aufruf verzögern, bis alle asynchronen Zeichnungsvorgänge durch den Coprozessor des Geräts abgeschlossen wurden. Dies bedeutet, dass GDI sicher auf eine vom Gerät verwaltete Oberfläche zugreifen kann.

DrvSynchronize soll Geräte unterstützen, die einen Coprozessor zum Zeichnen verwenden. Ein solches Gerät kann einige Zeichnungsvorgänge als asynchron behandeln und aus dem Vorgang zu GDI zurückkehren, bevor die Zeichnung abgeschlossen ist. Wenn dies der Fall ist, ist es möglich, dass ein nachfolgender Zeichnungsvorgang von GDI behandelt wird. Damit GDI sicher auf geräteverwaltete Oberflächen zugreifen kann, muss es über eine Möglichkeit verfügen, sicherzustellen, dass das asynchrone Rendering durch den Coprozessor des Geräts abgeschlossen ist. Durch Aufrufen dieser Funktion synchronisiert GDI den Zugriff auf eine geräteseitig verwaltete Oberfläche mit dem Treiber.

GDI ruft Nie DrvSynchronize für geräteseitig verwaltete Oberflächen auf. DrvSynchronize ist selbst keine Ausgabefunktion.