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

El IPrintOemUni::EnablePDEV método permite que un complemento de representación para Unidrv 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
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación

 

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

Comentarios

Un complemento de representación para Unidrv debe implementar el IPrintOemUni::EnablePDEV método .

El IPrintOemUni::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 IPrintOemUni::EnablePDEV archivo DLL de gráficos de impresora de Undrv llama al método desde su función DrvEnablePDEV .

El IPrintOemUni::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 IPrintOemUni::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 Unidrv. 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 Unidrv. 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)