Método IPrintOemPS::EnablePDEV (prcomoem.h)

El método IPrintOemPS::EnablePDEV permite que un complemento de representación para Pscript5 cree su propia estructura PDEV.

Sintaxis

HRESULT EnablePDEV(
        PDEVOBJ       pdevobj,
        PWSTR         pPrinterName,
        ULONG         cPatterns,
        HSURF         *phsurfPatterns,
        ULONG         cjGdiInfo,
        GDIINFO       *pGdiInfo,
        ULONG         cjDevInfo,
        DEVINFO       *pDevInfo,
        DRVENABLEDATA *pded,
  [out] OUT PDEVOEM   *pDevOem
);

Parámetros

pdevobj

Puntero proporcionado por el autor de la llamada a una estructura DEVOBJ.

pPrinterName

Puntero proporcionado por el autor de la llamada a una cadena de texto que representa la dirección lógica de la impresora.

cPatterns

Valor proporcionado por el autor de la llamada que representa el número de controladores de superficie con tipo HSURF contenidos en el búfer al que apunta phsurfPatterns.

phsurfPatterns

Puntero proporcionado por el autor de la llamada a un búfer lo suficientemente grande como para contener cPatterns número de identificadores de superficie con tipo HSURF. Los identificadores representan patrones de relleno de superficie.

cjGdiInfo

Valor proporcionado por el autor de la llamada que representa el tamaño de la estructura a la que apunta pGdiInfo.

pGdiInfo

Puntero proporcionado por el autor de la llamada a una estructura de GDIINFO.

cjDevInfo

Valor proporcionado por el autor de la llamada que representa el tamaño de la estructura a la que apunta pDevInfo.

pDevInfo

Puntero proporcionado por el autor de la llamada a una estructura DEVINFO.

pded

Puntero proporcionado por el autor de la llamada a una estructura de DRVENABLEDATA que contiene las direcciones de las funciones de enlace DDI de gráficos del controlador de impresora. Para obtener más información, vea la siguiente sección Comentarios.

[out] pDevOem

Recibe un puntero proporcionado por el método a una estructura PDEV privada. (Para obtener más información, vea la siguiente sección Comentarios).

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación
E_NOTIMPL	El método no se implementa.

 

Si se produce un error en la operación, el método debe llamar a SetLastError para establecer un código de error.

Observaciones

El método IPrintOemPS::EnablePDEV realiza los mismos tipos de operaciones que la función DrvEnablePDEV que exporta un archivo DLL de gráficos de impresora. Su propósito es permitir que un complemento de representación cree su propia estructura PDEV. (Para obtener más información sobre las estructuras PDEV, consulte estructuras PDEV personalizadas).

Si proporciona un complemento de representación que exporta el método IPrintOemPS::EnablePDEV, el archivo DLL de gráficos de impresora de Pscript5 llama al método desde su función DrvEnablePDEV.

El método IPrintOemPS::EnablePDEV debe asignar una instancia de su estructura PDEV privada, inicializarla y devolver su dirección como el parámetro pDevOem del método. Otros métodos del complemento reciben la dirección como el pdevOEM miembro de la estructura DEVOBJ de.

El miembro pdevOEM de la estructura DEVOBJ no se usa con el método IPrintOemPS::EnablePDEV.

Las estructuras a las que apunta la phsurfPatterns, pGdiInfoy pDevInfo valores de parámetro son los mismos que recibe la función drvEnablePDEV de Pscript5. El complemento de representación puede modificar el contenido de la estructura según sea necesario. Puede proporcionar patrones de relleno de superficie al obtener controladores de superficie con tipo HSURF y colocarlos en el búfer al que apunta phsurfPatterns. Los tipos de patrón de relleno y el orden de identificador se enumeran en la descripción de DrvEnablePDEV.

La estructura DRVENABLEDATA a la que apunta pded contiene las direcciones de las funciones DDI de gráficos gráficos proporcionadas por la DLL de gráficos de impresora de Pscript5. Puede proporcionar funciones de enlace personalizadas en el complemento para estas funciones DDI de gráficos. El contenido de la estructura DRVENABLEDATA permite que las funciones de enlace personalizadas vuelvan a llamar a las funciones DDI de gráficos del controlador. Para obtener más información, vea funciones DDI de gráficos personalizados.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	prcomoem.h (include Prcomoem.h)