IDirect3DVolumeTexture9::AddDirtyBox 메서드(d3d9helper.h)

볼륨 텍스처 리소스에 더티 영역을 추가합니다.

구문

HRESULT AddDirtyBox(
  [in] const D3DBOX *pDirtyBox
);

매개 변수

[in] pDirtyBox

형식: const D3DBOX*

추가할 더티 영역을 지정하는 D3DBOX 구조체에 대한 포인터입니다. NULL을 지정하면 전체 볼륨 텍스처를 포함하도록 더티 영역이 확장됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값을 D3DERR_INVALIDCALL 수 있습니다.

설명

성능상의 이유로 더티 영역은 텍스처의 수준 0에 대해서만 기록됩니다. sublevels의 경우 해당(크기 조정) 상자도 더티 가정합니다. 더티 지역은 D3DLOCK_NO_DIRTY_UPDATE 또는D3DLOCK_READONLY 없이 LockBox가 호출될 때 자동으로 기록됩니다.

D3DLOCK_NO_DIRTY_UPDATE 사용하고 더티 지역을 명시적으로 지정하면 UpdateTexture의 효율성을 높일 수 있습니다. 애플리케이션은 이 메서드를 사용하여 리소스에 더티 상자를 지정하여 복사되는 리소스의 하위 집합을 최적화할 수 있습니다. 그러나 맞춤을 최적화하기 위해 더티 영역을 확장할 수 있습니다.

요구 사항

대상 플랫폼	Windows
헤더	d3d9helper.h(D3D9.h 포함)
라이브러리	D3D9.lib

추가 정보

IDirect3DVolumeTexture9