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) |