IDirectDrawSurface7::Restore 메서드(ddraw.h)
손실된 표면을 복원합니다. DirectDrawSurface 개체와 연결된 표면 메모리가 해제된 경우에 발생합니다.
구문
HRESULT Restore();
반환 값
메서드가 성공하면 반환 값이 DD_OK.
실패하면 메서드는 다음 오류 값 중 하나를 반환할 수 있습니다.
- DDERR_GENERIC
- DDERR_IMPLICITLYCREATED
- DDERR_INCOMPATIBLEPRIMARY
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOEXCLUSIVEMODE
- DDERR_OUTOFMEMORY
- DDERR_UNSUPPORTED
- DDERR_WRONGMODE
설명
복원 은 표면에 할당된 메모리를 복원하지만 손실되기 전에 표면에 존재했을 수 있는 비트맵을 다시 로드하지 않습니다.
그래픽 어댑터의 모드가 변경되었거나 애플리케이션이 그래픽 어댑터에 대한 단독 액세스를 받고 어댑터에 현재 할당된 모든 표면 메모리를 해제했기 때문에 표면이 손실될 수 있습니다. DirectDrawSurface 개체가 표면 메모리를 잃으면 많은 메서드가 DDERR_SURFACELOST 반환하고 다른 함수를 수행하지 않습니다. IDirectDrawSurface7::Restore 메서드는 표면 메모리를 다시 할당하고 DirectDrawSurface 개체에 다시 연결합니다.
복원에 대한 단일 호출은 DirectDrawSurface 개체의 연결된 암시적 표면(백 버퍼 등)을 복원합니다. 암시적으로 생성된 표면을 복원하려고 시도하면 오류가 발생합니다. 복원 은 IDirectDrawSurface7::AddAttachedSurface 메서드를 사용하여 만든 명시적 첨부 파일에서 작동하지 않습니다. 이러한 각 표면은 개별적으로 복원해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | ddraw.h |
| 라이브러리 | Ddraw.lib |
| DLL | Ddraw.dll |