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 |