ID2D1Device::CreatePrintControl method

Creates an ID2D1PrintControl object that converts Direct2D primitives stored in ID2D1CommandList into a fixed page representation. The print sub-system then consumes the primitives.

Syntax


HRESULT CreatePrintControl(
  [in]            IWICImagingFactory *wicFactory,
  [in]            IPrintDocumentPackageTarget *documentTarget,
  [in, optional]  const D2D1_PRINT_CONTROL_PROPERTIES *printControlProperties,
  [out]           ID2D1PrintControl **printControl
);

Parameters

wicFactory [in]

Type: IWICImagingFactory*

A WIC imaging factory.

documentTarget [in]

Type: IPrintDocumentPackageTarget*

The target print job for this control.

printControlProperties [in, optional]

Type: const D2D1_PRINT_CONTROL_PROPERTIES*

The options to be applied to the print control.

printControl [out]

Type: ID2D1PrintControl**

When this method returns, contains the address of a pointer to an ID2D1PrintControl object.

Return value

Type: HRESULT

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

HRESULTDescription
S_OKNo error occurred.
E_OUTOFMEMORYDirect2D could not allocate sufficient memory to complete the call.
E_FAILGeneric failure code.
D2DERR_PRINT_FORMAT_NOT_SUPPORTEDThe print format is not supported by the document target.

 

Remarks

Note  This is a blocking or synchronous function and might not return immediately. How quickly this function returns depends on run-time factors such as network status, print server configuration, and printer driver implementation—factors that are difficult to predict when writing an application. Calling this function from a thread that manages interaction with the user interface could make the application appear to be unresponsive.

Requirements

Minimum supported client

Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Header

D2d1_1.h

Library

D2d1.lib

DLL

D2d1.dll

See also

ID2D1Device

 

 

Community Additions

ADD
Show:
© 2014 Microsoft