Método IPrintOemPS::EnablePDEV (prcomoem.h)
El IPrintOemPS::EnablePDEV
método 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 identificadores 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 que es 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 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 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 sección Comentarios que se muestra más adelante.
[out] pDevOem
Recibe un puntero proporcionado por el método a una estructura PDEV privada. (Para obtener más información, vea la sección Comentarios siguientes).
Valor devuelto
El método debe devolver uno de los valores siguientes.
Código devuelto | Descripción |
---|---|
|
La operación se realizó correctamente. |
|
Error en la operación |
|
El método no está implementado. |
Si se produce un error en la operación, el método debe llamar a SetLastError para establecer un código de error.
Comentarios
El IPrintOemPS::EnablePDEV
método realiza los mismos tipos de operaciones que la función DrvEnablePDEV exportada por 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, vea Estructuras PDEV personalizadas).
Si proporciona un complemento de representación que exporta el método, el IPrintOemPS::EnablePDEV
archivo DLL de gráficos de impresora de Pscript5 llama al método desde su función DrvEnablePDEV .
El IPrintOemPS::EnablePDEV
método debe asignar una instancia de su estructura PDEV privada, inicializarla y devolver su dirección como parámetro pDevOem del método. Otros métodos de complemento reciben la dirección como el miembro pdevOEM de la estructura DEVOBJ .
El miembro pdevOEM de la estructura DEVOBJ no se usa con el IPrintOemPS::EnablePDEV
método .
Las estructuras a las que apunta la función phsurfPatterns, pGdiInfo y pDevInfo son las mismas 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 suministrar patrones de relleno de superficie mediante la obtención de controladores de superficie con tipo HSURF y su colocación 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 proporcionadas por el archivo 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 | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | prcomoem.h (incluya Prcomoem.h) |