IDirect3DMobileTexture::LockRect

9/8/2008

Este método bloqueia um retângulo em um recurso de textura.

Syntax

HRESULT LockRect(
  UINT Level,
  D3DMLOCKED_RECT* pLockedRect,
  CONST RECT* pRect,
  DWORD Flags
);

Parameters

• Nível
  [no] Especifica o nível do recurso de textura para bloqueio.

• pLockedRect
  [out] Ponteiro para um D3DMLOCKED_RECT estrutura que descreve a região bloqueada.

• pRect
  [no] Ponteiro para um retângulo para bloqueio. Especificado por um ponteiro para um RECT estrutura. Especificando NULL para este parâmetro expande a região suja rosto a textura inteira.

• Sinalizadores
  [no] Uma combinação de um ou mais Valores D3DMLOCK Para descrever o tipo de bloqueio para executar. A seguinte lista mostra os sinalizadores permitidos.

  • D3DMLOCK_READONLY
  • D3DMLOCK_NO_DIRTY_UPDATE

Return Value

Se o método for bem-sucedido, o valor de retorno é D3DM_OK (consulte Valores D3DM).

Se o método falhar, o valor de retorno pode ser D3DMERR_INVALIDCALL (consulte Valores D3DMERR).

Remarks

Por motivos desempenho, regiões sujos somente são registrados para nível zero de uma textura. Regiões sujos são automaticamente registrados quando IDirect3DMobileTexture::LockRect é chamado sem D3DMLOCK_NO_DIRTY_UPDATE ou D3DMLOCK_READONLY (consulte Valores D3DMLOCK). Para obter mais informações, consulte IDirect3DMobileDevice::UpdateTexture.

Um backbuffer multisample não pode ser bloqueada. As texturas memória de vídeo não podem ser bloqueadas, mas devem ser modificadas por chamado IDirect3DMobileDevice::CopyRects Ou IDirect3DMobileDevice::UpdateTexture.

Requirements

Header	d3dm.h
Library	D3dm.lib, D3dmguid.lib
Windows Embedded CE	Windows CE 5.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

IDirect3DMobileTexture
D3DMLOCKED_RECT
D3DMLOCK Values
IDirect3DMobileDevice::UpdateTexture
IDirect3DMobileDevice::CopyRects
IDirect3DMobileDevice::UpdateTexture

Other Resources