IDirect3DTexture9::AddDirtyRect 메서드(d3d9helper.h)
텍스처 리소스에 더티 영역을 추가합니다.
구문
HRESULT AddDirtyRect(
[in] const RECT *pDirtyRect
);
매개 변수
[in] pDirtyRect
형식: const RECT*
추가할 더티 영역을 지정하는 RECT 구조체에 대한 포인터입니다. NULL을 지정하면 전체 텍스처를 포함하도록 더티 영역이 확장됩니다.
반환 값
형식: HRESULT
메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값을 D3DERR_INVALIDCALL 수 있습니다.
설명
성능상의 이유로 더티 영역은 텍스처의 수준 0에 대해서만 기록됩니다. sublevels의 경우 해당(크기 조정된) 사각형 또는 상자도 더티 가정합니다. 더티 지역은 IDirect3DTexture9::LockRect가 D3DLOCK_NO_DIRTY_UPDATE 또는D3DLOCK_READONLY 없이 호출될 때 자동으로 기록됩니다. IDirect3DDevice9::UpdateSurface의 대상 화면도 자동으로 더티 표시됩니다.
D3DLOCK_NO_DIRTY_UPDATE 사용하고 더티 지역을 명시적으로 지정하면 IDirect3DDevice9::UpdateTexture의 효율성을 높일 수 있습니다. 애플리케이션은 이 메서드를 사용하여 리소스에 더티 지역을 지정하여 복사되는 리소스의 하위 집합을 최적화할 수 있습니다. 그러나 맞춤을 최적화하기 위해 더티 영역을 확장할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | d3d9helper.h(D3D9.h 포함) |
| 라이브러리 | D3D9.lib |