IDirect3DCubeTexture9::LockRect 메서드(d3d9helper.h)

아티클
08/23/2023

큐브 텍스처 리소스에 사각형을 잠글 수 있습니다.

구문

HRESULT LockRect(
  [in]  D3DCUBEMAP_FACES FaceType,
  [in]  UINT             Level,
  [out] D3DLOCKED_RECT   *pLockedRect,
  [in]  const RECT       *pRect,
  [in]  DWORD            Flags
);

매개 변수

[in] FaceType

형식: D3DCUBEMAP_FACES

큐브 맵 얼굴을 식별하는 D3DCUBEMAP_FACES 열거형 형식의 멤버입니다.

[in] Level

형식: UINT

mipmapped 큐브 텍스처의 수준을 지정합니다.

[out] pLockedRect

형식: D3DLOCKED_RECT*

잠글 지역을 설명하는 D3DLOCKED_RECT 구조체에 대한 포인터입니다.

[in] pRect

형식: const RECT*

잠글 사각형에 대한 포인터입니다. RECT 구조체에 대한 포인터로 지정됩니다. 이 매개 변수에 NULL을 지정하면 전체 큐브 텍스처를 포함하도록 더티 영역이 확장됩니다.

[in] Flags

형식: DWORD

수행할 잠금 유형을 설명하는 0개 이상의 잠금 플래그 조합입니다. 이 메서드의 경우 유효한 플래그는 다음과 같습니다.

D3DLOCK_DISCARD
D3DLOCK_NO_DIRTY_UPDATE
D3DLOCK_NOSYSLOCK
D3DLOCK_READONLY

D3DLOCK_DISCARD 사용할 때 하위 항목을 지정할 수 없습니다. 플래그에 대한 설명은 D3DLOCK 참조하세요.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 하나 이상의 인수가 잘못된 경우 D3DERR_INVALIDCALL 반환됩니다.

설명

성능상의 이유로 더티 영역은 텍스처의 수준 0에 대해서만 기록됩니다. 더티 지역은 IDirect3DCubeTexture9::LockRect 가 D3DLOCK_NO_DIRTY_UPDATE 또는 D3DLOCK_READONLY 없이 호출될 때 자동으로 기록됩니다. 자세한 내용은 IDirect3DDevice9::UpdateTexture 를 참조하세요.

D3DPOOL_DEFAULT 사용하여 만든 큐브 텍스처는 잠글 수 없습니다. 비디오 메모리에서 만든 큐브 텍스처는 USAGE_DYNAMIC 사용하여 만들 때 잠글 수 있습니다.

깊이 스텐실 텍스처에 대해 잠글 수 있는 유일한 형식은 D3DFMT_D16_LOCKABLE.