ID2D1Device::CreatePrintControl(IWICImagingFactory*,IPrintDocumentPackageTarget*,constD2D1_PRINT_CONTROL_PROPERTIES*,ID2D1PrintControl**) method (d2d1_1.h)
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
[in] wicFactory
Type: IWICImagingFactory*
A WIC imaging factory.
[in] documentTarget
Type: IPrintDocumentPackageTarget*
The target print job for this control.
[in, optional] printControlProperties
Type: const D2D1_PRINT_CONTROL_PROPERTIES*
The options to be applied to the print control.
[out] printControl
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.
HRESULT | Description |
---|---|
S_OK | No error occurred. |
E_OUTOFMEMORY | Direct2D could not allocate sufficient memory to complete the call. |
E_FAIL | Generic failure code. |
D2DERR_PRINT_FORMAT_NOT_SUPPORTED | The print format is not supported by the document target. |
Remarks
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps] |
Minimum supported server | Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps] |
Target Platform | Windows |
Header | d2d1_1.h |
Library | D2d1.lib |
DLL | D2d1.dll |
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for