PDD_VPORTCB_GETLINE Rückruffunktion (ddrawint.h)

Die DdVideoPortGetLine-Rückruffunktion gibt die aktuelle Zeilennummer des Hardwarevideoports zurück.

Syntax

PDD_VPORTCB_GETLINE PddVportcbGetline;

DWORD PddVportcbGetline(
  PDD_GETVPORTLINEDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

Verweist auf eine DD_GETVPORTLINEDATA Struktur, die die Informationen enthält, die der Treiber zum Ermitteln und Zurückgeben der aktuellen Zeilennummer für den angegebenen Hardwarevideoport benötigt.

Rückgabewert

DdVideoPortGetLine gibt einen der folgenden Rückrufcodes zurück:

Hinweise

Treiber, die das DDVPCAPS_READBACKLINE-Flag im dwCaps-Member der DDVIDEOPORTCAPS-Struktur festlegen, müssen DdVideoPortGetLine implementieren.

Der Treiber sollte die Nummer der aktuellen Videozeile in den dwLine-Member der DD_GETVPORTLINEDATA-Struktur in lpGetLine schreiben. Die zurückgegebene Zeilennummer muss nullbasiert sein. Das heißt, die erste Zeile des Videos ist Zeile 0, die zweite Zeile des Videos ist Zeile 1 usw.

Wenn sich das Gerät in einem vertikalen Leerzeichen befindet, sollte der Treiber DDERR_VERTICALBLANKINPROGRESS im ddRVal-Element von DD_GETVPORTLINEDATA festlegen. Wenn die Abfrage nicht ausgeführt werden kann, weil der Hardwarevideoport deaktiviert ist, sollte der Treiber DDERR_VIDEONOTACTIVE in ddRVal festlegen. In beiden fällen sollte der Treiber DDHAL_DRIVER_HANDLED zurückgeben.

Anforderungen

Zielplattform	Desktop
Kopfzeile	ddrawint.h (einschließlich Winddi.h)

Weitere Informationen

DDVIDEOPORTCAPS

DD_GETVPORTLINEDATA