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

Weitere Informationen

IDirectDraw7