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