ID2D1Bitmap1::Map 메서드(d2d1_1.h)

지정된 비트맵을 메모리에 매핑합니다.

구문

HRESULT Map(
        D2D1_MAP_OPTIONS options,
  [out] D2D1_MAPPED_RECT *mappedRect
);

매개 변수

options

형식: D2D1_MAP_OPTIONS

비트맵을 메모리에 매핑하는 데 사용되는 옵션입니다.

[out] mappedRect

형식: D2D1_MAPPED_RECT*

이 메서드가 반환되면 메모리에 매핑되는 사각형에 대한 참조가 포함됩니다.

반환 값

형식: HRESULT

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

HRESULT	설명
S_OK	오류가 발생하지 않았습니다.
E_INVALIDARG	하나 이상의 인수가 잘못되었습니다.
D3DERR_DEVICELOST	디바이스가 손실되었지만 현재 초기화할 수 없습니다.

설명

참고 매핑하는 동안에는 비트맵을 사용할 수 없습니다. 특히 원본 또는 대상 비트맵이 매핑된 경우 ID2D1Bitmap::CopyFromBitmap 메서드가 작동하지 않습니다.

 

지정된 D2D1_BITMAP_OPTIONS_CPU_READ 플래그를 사용하여 비트맵을 만들어야 합니다.

요구 사항

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

추가 정보

ID2D1Bitmap1

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget::CreateSharedBitmap