Metode IPrintOemUni3::GetPDEVAdjustment (prcomoem.h)

Artikel
02/29/2024

Metode ini IPrintOemUni3::GetPDEVAdjustment memungkinkan plug-in untuk mengambil alih pengaturan PDEV tertentu.

Sintaks

HRESULT GetPDEVAdjustment(
        PDEVOBJ  pdevobj,
        DWORD    dwAdjustType,
        PVOID    pBuf,
        DWORD    cbBuffer,
  [out] OUT BOOL *pbAdjustmentDone
);

Parameter

pdevobj

Penunjuk ke struktur DEVOBJ .

dwAdjustType

Menentukan jenis penyesuaian yang diminta. Bendera berikut saat ini didukung.

Bendera	Makna
PDEV_ADJUST_GRAPHICS_RESOLUTION_TYPE	Sesuaikan pengaturan resolusi grafis yang dilaporkan dalam struktur PDEV. Untuk informasi selengkapnya, lihat struktur resolusi PDEV_ADJUST_GRAPHICS .
PDEV_IMAGEABLE_ORIGIN_AREA_TYPE	Sesuaikan area asal yang dapat direkam yang dilaporkan dalam struktur PDEV. Untuk informasi selengkapnya, lihat struktur PDEV_ADJUST_IMAGEABLE_ORIGIN_AREA .
PDEV_ADJUST_PHYSICAL_PAPER_SIZE_TYPE	Sesuaikan ukuran kertas fisik yang dilaporkan dalam struktur PDEV. Untuk informasi selengkapnya, lihat struktur PDEV_ADJUST_PAPER_PHYSICAL_SIZE .

pBuf

Penunjuk ke struktur yang berisi pengaturan terencana yang digunakan jika tidak ada perubahan. Struktur ini tercantum dalam tabel sebelumnya. Plug-in dapat menimpa pengaturan dalam struktur yang relevan.

cbBuffer

Menentukan ukuran, dalam byte, dari struktur yang ditujukkan oleh pBuf.

[out] pbAdjustmentDone

Penunjuk ke lokasi memori yang diatur plug-in ke TRUE ketika benar-benar mengubah nilai di buffer. Ini dapat digunakan oleh driver untuk pengoptimalan.

Mengembalikan nilai

Metode IPrintOemUni3::GetPDEVAdjustment harus mengembalikan S_OK jika mengenali jenis penyesuaian, dan S_FALSE jika tidak. Jika metode gagal, metode harus mengembalikan E_FAIL. Rantai plug-in dipanggil hingga S_OK atau kode kegagalan selain E_NOTIMPL dikembalikan. Artinya, rantai plug-in dipanggil sampai plug-in pertama yang mampu menangani penyesuaian ditemukan.

Keterangan

Fungsi ini tersedia di Windows Vista dan yang lebih baru.

Saat ini, driver Unidrv memanggil IPrintOemUni3::GetPDEVAdjustment untuk menyesuaikan pengaturan resolusi grafis, seperti yang dilaporkan dalam PDEV, untuk menyesuaikan area asal yang dapat digambarkan, atau untuk menyesuaikan ukuran kertas fisik.