IWICBitmapSource::CopyPixels 메서드(wincodec.h)

개체에 픽셀을 생성하도록 지시합니다.

구문

HRESULT CopyPixels(
  [in]  const WICRect *prc,
  [in]  UINT          cbStride,
  [in]  UINT          cbBufferSize,
  [out] BYTE          *pbBuffer
);

매개 변수

[in] prc

형식: const WICRect*

복사할 사각형입니다. NULL 값은 전체 비트맵을 지정합니다.

[in] cbStride

형식: UINT

비트맵의 보폭

[in] cbBufferSize

형식: UINT

버퍼의 크기입니다.

[out] pbBuffer

형식: BYTE*

버퍼에 대한 포인터입니다.

반환 값

형식: HRESULT

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

설명

CopyPixels는 실제 처리를 트리거하는 두 기본 이미지 처리 루틴(다른 하나는 잠금)중 하나입니다. 알고리즘에 따라 픽셀을 생성하도록 개체에 지시합니다. 여기에는 디스크에 저장된 JPEG의 일부를 디코딩하거나 메모리 블록을 복사하거나 복잡한 그라데이션을 분석적으로 계산하는 작업이 포함될 수 있습니다. 알고리즘은 인터페이스를 구현하는 개체에 완전히 종속됩니다.

호출자는 prc 매개 변수를 사용하여 ROI(관심 있는 사각형)로 작업을 제한할 수 있습니다. ROI 하위 사각형은 비트맵의 범위에 완전히 포함되어야 합니다. NULL ROI를 지정하면 전체 비트맵이 반환되어야 합니다.

호출자는 메모리 관리를 제어하고 버퍼의 범위(cbBufferSize)와 함께 복사 결과에 대한 출력 버퍼(pbBuffer)를 제공해야 합니다. cbStride 매개 변수는 출력 버퍼에서 세로로 인접한 두 픽셀 사이의 바이트 수를 정의합니다. 호출자는 비트맵의 너비, 높이 및 픽셀 형식과 복사 메서드에 제공된 하위 사각형에 따라 호출을 완료하기에 충분한 버퍼가 있는지 확인해야 합니다.

호출자가 JPEG와 같은 값비싼 IWICBitmapSource 의 여러 복사본을 수행해야 하는 경우 먼저 메모리 내 IWICBitmap을 만드는 것이 좋습니다.

코덱 개발자 설명

호출 수신자는 출력 버퍼의 각 줄의 첫 번째(prc-Width>*bitsperpixel+7)/8바이트에만 씁니다(이 경우 줄은 연속된 cbStride 바이트 문자열임).

요구 사항

지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	wincodec.h
라이브러리	Windowscodecs.lib
DLL	Windowscodecs.dll