Método IPrintOemDriverUni::D rvYMoveTo (prcomoem.h)

Artículo
02/07/2025

El controlador Unidrv proporciona el método IPrintOemDriverUni::DrvYMoveTo para que un complemento de representación de pueda notificar al controlador los cambios de posición y del cursor.

Sintaxis

HRESULT DrvYMoveTo(
        PDEVOBJ pdevobj,
        INT     y,
        DWORD   dwFlags,
  [out] OUT INT *piResult
);

Parámetros

pdevobj

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

y

Valor proporcionado por el autor de la llamada que representa el número de unidades que debe mover el cursor. La unidad se define mediante las marcas de MV_GRAPHICS en dwFlags.

dwFlags

Una o varias de las siguientes marcas de bits proporcionadas por el autor de la llamada:

Bandera	Definición
MV_GRAPHICS	Si se establece, el y valor del parámetro se expresa en puntos, en función de la resolución actual de la impresora. Por ejemplo, si la resolución y es de 150 PPP y y es 75, el movimiento es ?? pulgada. Si no se establece, el y valor del parámetro se expresa en unidades maestras. Por ejemplo, si la unidad maestra y es 600 y y es 300, el movimiento es ?? pulgada.
MV_PHYSICAL	Si se establece, el y valor del parámetro es relativo al origen del cursor. Si no se establece, el y valor del parámetro es relativo al origen del área imprimible. No se puede establecer si se establece MV_RELATIVE.
MV_RELATIVE	Si se establece, especifica que el cursor se debe mover y unidades de su posición actual. Si no se establece, especifica que el cursor se debe mover y unidades desde su origen.
MV_UPDATE	Si se establece, especifica que Unidrv debe actualizar su cálculo actual de la posición del cursor sin mover realmente el cursor. (Debe establecerse si IPrintOemUni::ImageProcessing ha movido el cursor). Si no se establece, especifica que Unidrv debe actualizar su cálculo actual de la posición del cursor y también mover el cursor.

[out] piResult

Recibe el resultado proporcionado por el método de restar la nueva posición real del cursor del nuevo cursor solicitado. Este valor puede ser cero, pero siempre no es negativo.

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.

Observaciones

Los métodos IPrintOemDriverUni::D rvXMoveTo y IPrintOemDriverUni::DrvYMoveTo permiten que un complemento de representación envíe datos de imagen al colador de impresoras sin hacer que el controlador de impresora pierda el seguimiento de la posición del cursor de la impresora. Si proporciona un método IPrintOemUni::ImageProcessing que envía datos de imagen directamente al administrador de trabajos de impresión en lugar de devolverlos al controlador de impresora, el método debe llamar a IPrintOemDriverUni::DrvXMoveTo y IPrintOemDriverUni::DrvYMoveTo.

Se pueden usar cualquiera de estas dos técnicas para actualizar la posición del cursor:

Cada vez que un método IPrintOemUni::ImageProcessing necesita actualizar la posición del cursor, puede llamar a IPrintOemDriverUni::DrvXMoveTo o IPrintOemDriverUni::DrvYMoveTo con la marca MV_UPDATE desactivada. Esto hace que Unidrv envíe comandos de cursor al administrador de trabajos de impresión y actualice su cálculo interno de la posición actual del cursor.
El método IPrintOemUni::ImageProcessing puede actualizar el cursor enviando comandos de cursor directamente al administrador de trabajos de impresión. Cuando el método haya terminado su operación de cola, puede llamar a IPrintOemDriverUni::DrvXMoveTo o IPrintOemDriverUni::DrvYMoveTo con la marca MV_UPDATE establecida. Esto hace que Unidrv actualice su cálculo interno de la posición actual del cursor sin enviar comandos de cursor a la cola de impresión.

Requisitos

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

Compartir a través de