DCIBeginAccess function (dciman.h)

[This function is subject to change with each operating system revision. Instead, use the Microsoft DirectDraw and Microsoft Direct3DAPIs; these APIs insulate applications from such operating system changes, and hide many other difficulties involved in interacting directly with display drivers.]

Obtains an access pointer to display frame buffer based on the given rectangle.

Syntax

DCIRVAL DCIBeginAccess(
  [in] LPDCISURFACEINFO pdci,
  [in] int              x,
  [in] int              y,
  [in] int              dx,
  [in] int              dy
);

Parameters

[in] pdci

A pointer to a DCISURFACEINFO structure.

[in] x

The x-coordinate of the upper-left corner of the rectangle.

[in] y

The y-coordinate of the upper-left corner of the rectangle.

[in] dx

The width of the rectangle.

[in] dy

The height of the rectangle.

Return value

If the function succeeds, the return value is DCI_OK or DCI_STATUS_POINTERCHANGED. DCI_STATUS_POINTERCHANGED indicates that the virtual address of the frame buffer could have been changed since the last call. So the application should not assume the consistency of the virtual address of the display frame buffer. If the function fails, the return value is one of the DCI errors.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	dciman.h
Library	Dciman32.lib
DLL	Dciman32.dll

See also

Graphics Low Level Client Support