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 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | d2d1_1.h |
| 程式庫 | D2d1.lib |