IDirectDraw7::GetScanLine-Methode (ddraw.h)
Ruft die Scanlinie ab, die derzeit auf dem Monitor gezeichnet wird.
Syntax
HRESULT GetScanLine(
[out] LPDWORD unnamedParam1
);
Parameter
[out] unnamedParam1
Ein Zeiger auf eine Variable, die die Scanlinie empfängt, die die Anzeige derzeit zeichnet.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.
Wenn ein Fehler auftritt, kann die Methode einen der folgenden Fehlerwerte zurückgeben:
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_UNSUPPORTED
- DDERR_VERTICALBLANKINPROGRESS
Hinweise
Scanzeilen werden als nullbasierte ganze Zahlen gemeldet. Der zurückgegebene Wert der Scanzeile liegt im Bereich von 0 bis n, wobei 0 die erste sichtbare Scanzeile auf dem Bildschirm und n die letzte sichtbare Scanzeile ist, sowie alle Scanzeilen, die während des vertikalen Leerzeitraums auftreten. In einem Fall, in dem eine Anwendung mit einer Auflösung von 640×480 ausgeführt wird und während vblank 12 Scanlinien vorhanden sind, liegen die von dieser Methode zurückgegebenen Werte zwischen 0 und 491.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |