PFND3DDDI_FLUSH Rückruffunktion (d3dumddi.h)
Die Flush-Funktion sendet herausragende Hardwarebefehle, die sich im Hardwarebefehlspuffer befinden, an den Miniporttreiber der Anzeige.
Syntax
PFND3DDDI_FLUSH Pfnd3dddiFlush;
HRESULT Pfnd3dddiFlush(
HANDLE hDevice
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
Rückgabewert
Flush gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Hardwarebefehle wurden erfolgreich geleert. |
| E_OUTOFMEMORY | "Flush" konnte den erforderlichen Arbeitsspeicher nicht zuordnen, damit er abgeschlossen werden kann. |
Bemerkungen
Die Microsoft Direct3D-Laufzeit kann die Flush--Funktion des Benutzermodustreibers jederzeit aufrufen, um den Anzeigetreiber des Benutzermodus zu benachrichtigen, um alle ausstehenden Hardwarebefehle, die sich im Hardwarebefehlspuffer befinden, an den Anzeigeminiporttreiber zu übermitteln. Ein Aufruf von Flush sollte jedoch niemals dazu führen, dass der Anzeigetreiber für den Benutzermodus ungültige Befehle an den Anzeigeminiporttreiber sendet.
Um Befehle an den Anzeigeminiporttreiber zu übermitteln, sollte die Flush--Funktion des Benutzermodus in der Regel die pfnRenderCb--Funktion der Laufzeit aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |