Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
This method locks a rectangle on a texture resource.
HRESULT LockRect( UINT Level, D3DMLOCKED_RECT* pLockedRect, CONST RECT* pRect, DWORD Flags);
Parameters
- Level
[in] Specifies the level of the texture resource to lock. - pLockedRect
[out] Pointer to a D3DMLOCKED_RECT structure that describes the locked region. - pRect
[in] Pointer to a rectangle to lock. Specified by a pointer to a RECT structure. Specifying NULL for this parameter expands the dirty region to cover the entire texture. - Flags
[in] A combination of one or more D3DMLOCK Values to describe the type of lock to perform. The following list shows the allowable flags.- D3DMLOCK_READONLY
- D3DMLOCK_NO_DIRTY_UPDATE
Return Values
If the method succeeds, the return value is D3DM_OK (see D3DM Values).
If the method fails, the return value can be D3DMERR_INVALIDCALL (see D3DMERR Values).
Remarks
For performance reasons, dirty regions are only recorded for level zero of a texture. Dirty regions are automatically recorded when IDirect3DMobileTexture::LockRect is called without D3DMLOCK_NO_DIRTY_UPDATE or D3DMLOCK_READONLY (see D3DMLOCK Values). For more information, see IDirect3DMobileDevice::UpdateTexture.
A multisample backbuffer cannot be locked. Video memory textures cannot be locked, but must be modified by calling IDirect3DMobileDevice::CopyRects or IDirect3DMobileDevice::UpdateTexture.
Requirements
OS Versions: Windows CE 5.0 and later.
Header: D3dm.h.
Link Library: D3dm.lib, D3dmguid.lib.
See Also
IDirect3DMobileTexture | D3DMLOCKED_RECT | RECT | D3DMLOCK Values | IDirect3DMobileDevice::UpdateTexture | IDirect3DMobileDevice::CopyRects | IDirect3DMobileDevice::UpdateTexture
Send Feedback on this topic to the authors