DD_GETSCANLINEDATA structure (ddrawint.h)

The DD_GETSCANLINEDATA structure contains the members required to query and return the number of the current scan line.

Syntax

typedef struct _DD_GETSCANLINEDATA {
  PDD_DIRECTDRAW_GLOBAL lpDD;
  DWORD                 dwScanLine;
  HRESULT               ddRVal;
  VOID                  *GetScanLine;
} *PDD_GETSCANLINEDATA, DD_GETSCANLINEDATA;

Members

lpDD

Points to a DD_DIRECTDRAW_GLOBAL structure that describes the driver's device.

dwScanLine

Specifies the location in which the driver returns the number of the current scan line. See the Remarks section for more information.

ddRVal

Specifies the location in which the driver writes the return value of the DdGetScanLine callback. A return code of DD_OK indicates success. For more information, see Return Values for DirectDraw.

GetScanLine

Used by the Microsoft DirectDraw API and should not be filled in by the driver.

Remarks

The returned scan line value in dwScanLine must be greater than or equal to 0 and less than N, where N is the sum of the number of visible scan lines and the number of scan lines that occur during vertical blank. For example, with a display operating at a resolution of 640x480, that has 12 scan lines during vertical blank, the value returned to GetScanLine could range from 0 to 491.

Requirements

Requirement Value
Header ddrawint.h (include Winddi.h)

See also

DdGetScanLine