ID2D1Device::CreatePrintControl(IWICImagingFactory*,IPrintDocumentPackageTarget*,constD2D1_PRINT_CONTROL_PROPERTIES*,ID2D1PrintControl**) (d2d1_1.h)

  • Artículo

Crea un objeto ID2D1PrintControl que convierte primitivos de Direct2D almacenados en ID2D1CommandList en una representación de página fija. A continuación, el subsistema de impresión consume los primitivos.

Sintaxis

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

Parámetros

[in] wicFactory

Tipo: IWICImagingFactory*

Una fábrica de imágenes WIC.

[in] documentTarget

Tipo: IPrintDocumentPackageTarget*

Trabajo de impresión de destino para este control.

[in, optional] printControlProperties

Tipo: const D2D1_PRINT_CONTROL_PROPERTIES*

Las opciones que se van a aplicar al control de impresión.

[out] printControl

Tipo: ID2D1PrintControl**

Cuando este método finaliza, contiene la dirección de un puntero a un objeto ID2D1PrintControl .

Valor devuelto

Tipo: HRESULT

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

HRESULT Descripción
S_OK No se ha producido ningún error.
E_OUTOFMEMORY Direct2D no pudo asignar suficiente memoria para completar la llamada.
E_FAIL Código de error genérico.
D2DERR_PRINT_FORMAT_NOT_SUPPORTED El destino del documento no admite el formato de impresión.

Comentarios

Nota Se trata de una función de bloqueo o sincrónica y podría no devolverse inmediatamente. La rapidez con la que devuelve esta función depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y la implementación del controlador de impresora, factores que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado d2d1_1.h
Library D2d1.lib
Archivo DLL D2d1.dll

Consulte también

ID2D1Device