ID2D1Bitmap::CopyFromMemory 메서드(d2d1.h)

메모리에서 현재 비트맵으로 지정된 영역을 복사합니다.

구문

HRESULT CopyFromMemory(
  [in, optional] const D2D1_RECT_U *dstRect,
  [in]           const void        *srcData,
                 UINT32            pitch
);

매개 변수

[in, optional] dstRect

형식: const D2D1_RECT_U*

현재 비트맵에서 srcRect 로 지정된 영역이 복사되는 사각형입니다.

[in] srcData

형식: const void*

복사할 데이터입니다.

pitch

형식: UINT32

srcData에 저장된 원본 비트맵의 stride 또는 pitch입니다. 보폭은 스캔라인의 바이트 수(메모리의 픽셀 한 행)입니다. 보폭은 픽셀 너비 * 픽셀당 바이트 + 메모리 패딩 수식에서 계산할 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드는 현재 비트맵의 크기를 업데이트하지 않습니다. 원본 비트맵의 내용이 현재 비트맵에 맞지 않으면 이 메서드가 실패합니다. 또한 이 메서드는 형식 변환을 수행하지 않습니다. 두 비트맵 형식이 일치해야 합니다.

이 메서드가 잘못된 입력(예: 잘못된 대상 사각형)으로 전달되면 왜곡된 이미지 또는 디바이스 오류와 같은 예측할 수 없는 결과를 생성할 수 있습니다.

이 메서드를 호출하면 비트맵이 일괄 처리에서 활성화된 경우 현재 일괄 처리가 플러시될 수 있습니다. 플러시된 일괄 처리가 성공적으로 완료되지 않으면 이 메서드가 실패합니다. 그러나 이 메서드는 일괄 처리가 플러시된 렌더링 대상의 오류 상태를 지우지 않습니다. 실패한 HRESULT 및 태그 상태는 EndDraw 또는 Flush에 대한 다음 호출 시 반환됩니다.

Windows 8.1 이 메서드는 블록 압축 비트맵을 지원합니다. 블록 압축 형식을 사용하는 경우 srcRect 매개 변수의 끝 좌표는 4의 배수이거나 메서드가 E_INVALIDARG 반환해야 합니다.

요구 사항

추가 정보

ID2D1Bitmap