Método IPrintOemPS::GetInfo (prcomoem.h)
Un método de IPrintOemPS::GetInfo del complemento de representación devuelve información de identificación.
Sintaxis
HRESULT GetInfo(
DWORD dwMode,
PVOID pBuffer,
DWORD cbSize,
PDWORD pcbNeeded
);
Parámetros
dwMode
Contiene una de las siguientes constantes de entero proporcionadas por el autor de la llamada.
OEMGI_GETPUBLISHERINFO
El método debe indicar si el complemento de representación usará el "modo de publicación". El parámetro pBuffer apunta a una estructura de PUBLISHERINFO, que se rellenará mediante el método . Para obtener más información, vea la siguiente sección Comentarios.
OEMGI_GETREQUESTEDHELPERINTERFACES
El método debe escribir el valor de marca de bits de OEMPUBLISH_IPRINTCOREHELPER en el búfer pBuffer si se debe llamar al método IPrintOemPS::P ublishDriverInterface con el parámetro pIUnknown apuntando a un objeto que implementa la interfaz IPrintCoreHelperPS.
OEMGI_GETSIGNATURE
El método debe devolver una firma de identificación única de cuatro bytes. El complemento también debe colocar esta firma en estructuras de OPTITEM, como se describe en la descripción del OEMCUIPPARAM. miembro pOEMOptItems de la estructura.
OEMGI_GETVERSION
El método debe devolver el número de versión del complemento de la interfaz de usuario como DWORD. El formato de versión está definido por el desarrollador.
pBuffer
Puntero proporcionado por el autor de llamada a la memoria asignada para recibir la información especificada por dwMode.
cbSize
Tamaño proporcionado por el autor de la llamada del búfer al que apunta pBuffer.
pcbNeeded
Puntero proporcionado por el autor de la llamada a una ubicación para recibir el número de bytes escritos en el búfer al que apunta pBuffer.
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 se implementa. |
Observaciones
Los complementos de representación para Pscript5 son necesarios para implementar el método IPrintOemPS::GetInfo, al que se llama inmediatamente después de cargar el complemento. El método debe devolver la información especificada escribiendo en la dirección especificada por pBuffer y escribiendo el tamaño, en bytes, de la información devuelta en la ubicación especificada por pcbNeededed.
Si pBuffer es NULL, el método solo debe usar pcbNeeded para devolver el número de bytes necesarios para almacenar la información especificada.
En el "modo de publicación", toda la información de fuente que se va a descargar se coloca en el encabezado del trabajo. Cada fuente solo se descarga una vez y se puede usar para cualquier página, lo que permite que el trabajo sea independiente del orden de página. Si dwMode es OEMGI_GETPUBLISHERINFO, pero el complemento no admite el modo de publicación, IPrintOemPS::GetInfo debe devolver E_NOTIMPL.
Para obtener más información sobre cómo crear e instalar complementos de representación, vea Personalización de los controladores de impresora de Microsoft.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | prcomoem.h (include Prcomoem.h) |