Share via

ID2D1DeviceContext::GetTarget 메서드(d2d1_1.h)

  • 아티클

현재 디바이스 컨텍스트와 연결된 대상을 가져옵니다.

구문

void GetTarget(
  [out, optional] ID2D1Image **image
);

매개 변수

[out, optional] image

형식: ID2D1Image**

이 메서드가 반환될 때 에는 현재 디바이스 컨텍스트와 연결된 대상에 대한 포인터의 주소가 포함됩니다.

반환 값

없음

설명

대상이 디바이스 컨텍스트와 연결되지 않은 경우 메서드가 반환될 때 대상 에 NULL 이 포함됩니다.

현재 선택한 대상이 명령 목록이 아닌 비트맵인 경우 애플리케이션은 다음 방법 중 하나를 사용하여 만든 초기 비트맵에 액세스할 수 있습니다.

애플리케이션에서 이러한 비트맵을 삭제할 수 없습니다. 이러한 모든 비트맵은 비트맵 대상으로 바인딩할 수 있습니다. 그러나 이러한 비트맵을 모두 ID2D1RenderTarget 메서드의 비트맵 원본으로 사용할 수 있는 것은 아닙니다.

CreateDxgiSurfaceRenderTarget 은 DXGI 표면을 셰이더 리소스 뷰로 바인딩할 수 있는 경우 비트맵 원본으로 사용할 수 있는 비트맵을 만듭니다.

CreateCompatibleRenderTarget 은 항상 비트맵 원본으로 사용할 수 있는 비트맵을 만듭니다.

ID2D1RenderTarget::BeginDraw 는 HDC에서 연결된 원래 비트맵으로 복사합니다. ID2D1RenderTarget::EndDraw 는 원래 비트맵에서 HDC로 복사됩니다.

IWICBitmap 개체는 다음과 같은 상황에서 잠깁니다.

  • BeginDraw가 호출되었으며 현재 선택된 대상 비트맵은 WIC 비트맵입니다.
  • WIC 비트맵은 BeginDraw가 호출된 후 EndDraw가 호출되기 전에 디바이스 컨텍스트의 대상으로 설정됩니다.
  • ID2D1Bitmap::Copy* 메서드는 WIC 비트맵을 원본 또는 대상으로 사용하여 호출됩니다.
IWICBitmap 개체는 다음과 같은 상황에서 잠금 해제됩니다.
  • EndDraw가 호출되고 현재 선택된 대상 비트맵은 WIC 비트맵입니다.
  • WIC 비트맵은 BeginDraw와 EndDraw 호출 간에 디바이스 컨텍스트의 대상으로 제거됩니다.
  • ID2D1Bitmap::Copy* 메서드는 WIC 비트맵을 원본 또는 대상으로 사용하여 호출됩니다.
Direct2D는 현재 잠겨 있지 않은 비트맵만 잠깁니다.

ID2D1GdiInteropRenderTarget에 대해 QueryInterface를 호출하면 항상 성공합니다. ID2D1GdiInteropRenderTarget::GetDC 는 현재 바인딩된 대상 비트맵에 해당하는 디바이스 컨텍스트를 반환합니다. 대상 비트맵이 GDI_COMPATIBLE 플래그 집합으로 만들어지지 않은 경우 GetDC가 실패합니다.

렌더링 대상과 연결된 원래 대상 비트맵에 대한 미해결 참조가 있는 경우 ID2D1HwndRenderTarget::Resize는 DXGI_ERROR_INVALID_CALL 반환합니다.

대상은 명령 목록일 수 있지만 다른 유형의 이미지일 수는 없습니다. 효과의 출력 이미지일 수 없습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 d2d1_1.h
DLL D2d1.dll

추가 정보

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::SetTarget