Método IPrintOemUni::D ownloadCharGlyph (prcomoem.h)

El IPrintOemUni::DownloadCharGlyph método permite que un complemento de representación para Unidrv envíe un glifo de caracteres para una fuente temporal especificada a la impresora.

Sintaxis

HRESULT DownloadCharGlyph(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
        HGLYPH      hGlyph,
        PDWORD      pdwWidth,
  [out] OUT DWORD   *pdwResult
);

Parámetros

pdevobj

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

pUFObj

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

hGlyph

Controlador de glifo proporcionado por el autor de la llamada.

pdwWidth

Puntero proporcionado por el autor de la llamada para recibir el ancho proporcionado por el método del carácter.

[out] pdwResult

Recibe un valor proporcionado por el método que representa la cantidad de memoria de la impresora, en bytes, necesaria para almacenar el glifo de caracteres. Si se produce un error en la operación, el valor devuelto debe ser cero.

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 está implementado.

Comentarios

El IPrintOemUni::DownloadCharGlyph método se usa para admitir fuentes suaves en impresoras que no aceptan comandos PCL . Su propósito es permitir que un complemento de representación envíe un glifo de caracteres a la impresora.

Si un complemento de representación implementa el IPrintOemUni::DownloadCharGlyph método , Unidrv llama al método inmediatamente después de enviar la cadena de comando especificada por la entrada de comando CmdSetCharCode, que se encuentra en el archivo GPD de la impresora. (Los archivos GPD se describen en Microsoft Universal Printer Driver). El método debe hacer lo siguiente:

• Llame a la función UNIFONTOBJ_GetInfo para obtener la imagen de glifo especificada por hGlyph.
• Llame a IPrintOemDriverUni::D rvWriteSpoolBuf para enviar el glifo a la impresora.
• Vuelva a llamar a la función UNIFONTOBJ_GetInfo para obtener el ancho del glifo y, a continuación, almacene el ancho en la dirección a la que apunta pdwWidth.
• Devuelve la cantidad de memoria de la impresora necesaria para almacenar el glifo colocándolo en la ubicación especificada por pdwResult.

El IPrintOemUni::DownloadCharGlyph método es opcional. Si un complemento de representación implementa este método, el método IPrintOemUni::GetImplementedMethod del complemento debe devolver S_OK cuando recibe "DownloadCharGlyph" como entrada.

Si implementa el IPrintOemUni::DownloadCharGlyph método , también debe implementar el método IPrintOemUni::D ownloadFontHeader .

Para obtener más información, consulte Administración de fuentes personalizadas.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (include Prcomoem.h)