PDD_SURFCB_GETBLTSTATUS Rückruffunktion (ddrawint.h)
Die DdGetBltStatus-Rückruffunktion fragt den blit status der angegebenen Oberfläche ab.
Syntax
PDD_SURFCB_GETBLTSTATUS PddSurfcbGetbltstatus;
DWORD PddSurfcbGetbltstatus(
PDD_GETBLTSTATUSDATA unnamedParam1
)
{...}
Parameter
unnamedParam1
Verweist auf eine DD_GETBLTSTATUSDATA-Struktur, die die informationen enthält, die zum Ausführen der Blit-status Abfrage erforderlich sind.
Rückgabewert
DdGetBltStatus gibt einen der folgenden Rückrufcodes zurück:
Hinweise
Die vom Treiber zurückgegebene Blit-status basiert wie folgt auf dem dwFlags-Member der Struktur, auf die lpGetBltStatus verweist:
- Wenn das Flag DDGBS_CANBLT ist, sollte der Treiber bestimmen, ob die Oberfläche derzeit an einem Flip beteiligt ist. Wenn kein Flip ausgeführt wird und die Hardware ansonsten eine Blit-Anforderung annehmen kann, sollte der Treiber DD_OK im ddRVal-Member der Struktur zurückgeben, auf die lpGetBltStatus verweist. Wenn ein Flip ausgeführt wird oder die Hardware derzeit keine weitere Blit-Anforderung akzeptieren kann, sollte der Treiber das ddRVal-Element auf DDERR_WASSTILLDRAWING festlegen.
- Wenn das Flag DDGBS_ISBLTDONE ist, sollte der Treiber ddRVal auf DDERR_WASSTILLDRAWING festlegen, wenn derzeit ein Blit ausgeführt wird. Andernfalls sollte DD_OK zurückgegeben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | ddrawint.h (einschließlich Winddi.h) |