ID2D1PrintControl::AddPage 메서드(d2d1_1.h)

전달된 명령 목록의 Direct2D 기본 형식을 인쇄 하위 시스템에 사용할 고정 페이지 표현으로 변환합니다.

구문

HRESULT AddPage(
  [in]            ID2D1CommandList *commandList,
                  D2D_SIZE_F       pageSize,
  [in, optional]  IStream          *pagePrintTicketStream,
  [out, optional] D2D1_TAG         *tag1,
  [out, optional] D2D1_TAG         *tag2
);

매개 변수

[in] commandList

형식: ID2D1CommandList*

렌더링 작업이 포함된 명령 목록입니다.

pageSize

형식: D2D_SIZE_F

추가할 페이지의 크기(DIP)(1인치 == 96 DIP)입니다. 인쇄 드라이버가 이 매개 변수에 응답하지 않으면 pagePrintTicketStream 을 대신 사용할 수 있습니다.

[in, optional] pagePrintTicketStream

형식: IStream*

인쇄 티켓 스트림입니다. 이를 사용하여 현재 페이지의 속성을 수정할 수 있습니다. 예를 들어 용지 크기 또는 방향입니다.

[out, optional] tag1

형식: D2D1_TAG*

후속 그리기 작업에 대한 첫 번째 레이블을 포함합니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다. NULL을 지정하면 이 매개 변수에 대한 값이 검색되지 않습니다.

[out, optional] tag2

형식: D2D1_TAG*

후속 그리기 작업에 대한 두 번째 레이블을 포함합니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다. NULL을 지정하면 이 매개 변수에 대한 값이 검색되지 않습니다.

반환 값

형식: HRESULT

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

HRESULT	설명
S_OK	오류가 발생하지 않았습니다.
E_OUTOFMEMORY	Direct2D에서 호출을 완료하는 데 충분한 메모리를 할당할 수 없습니다.
E_INVALIDARG	잘못된 매개 변수가 반환 함수에 전달되었습니다.
D2DERR_PRINT_JOB_CLOSED	인쇄 작업이 이미 완료되었습니다.

요구 사항

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

추가 정보

ID2D1PrintControl