IPrintOemUni::D ownloadCharGlyph method (prcomoem.h)

  • Artikel

Metode ini IPrintOemUni::DownloadCharGlyph memungkinkan plug-in penyajian untuk Unidrv untuk mengirim glyph karakter untuk font lunak tertentu ke printer.

Sintaks

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

Parameter

pdevobj

Penunjuk yang disediakan penelepon ke struktur DEVOBJ .

pUFObj

Penunjuk yang disediakan penelepon ke struktur UNIFONTOBJ .

hGlyph

Handel glyph yang disediakan penelepon.

pdwWidth

Penunjuk yang disediakan penelepon untuk menerima lebar karakter yang disediakan metode.

[out] pdwResult

Menerima nilai yang disediakan metode yang mewakili jumlah memori printer, dalam byte, yang diperlukan untuk menyimpan glyph karakter. Jika operasi gagal, nilai yang dikembalikan harus nol.

Nilai kembali

Metode harus mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Operasi berhasil.
E_FAIL
 Operasi gagal
E_NOTIMPL
 Metode ini tidak diterapkan.

Keterangan

Metode IPrintOemUni::DownloadCharGlyph ini digunakan untuk mendukung font lunak pada printer yang tidak menerima perintah PCL . Tujuannya adalah untuk mengaktifkan plug-in penyajian untuk mengirim glyph karakter ke printer.

Jika plug-in penyajian mengimplementasikan IPrintOemUni::DownloadCharGlyph metode , Unidrv memanggil metode segera setelah mengirim string perintah yang ditentukan oleh entri perintah CmdSetCharCode, yang terkandung dalam file GPD printer. (File GPD dijelaskan dalam Microsoft Universal Printer Driver.) Metode harus melakukan hal berikut:

  • Panggil fungsi UNIFONTOBJ_GetInfo untuk mendapatkan gambar glyph yang ditentukan oleh hGlyph.
  • Panggil IPrintOemDriverUni::D rvWriteSpoolBuf untuk mengirim glyph ke printer.
  • Panggil fungsi UNIFONTOBJ_GetInfo lagi untuk mendapatkan lebar glyph, lalu simpan lebar di alamat yang diarahkan oleh pdwWidth.
  • Mengembalikan jumlah memori printer yang diperlukan untuk menyimpan glyph dengan menempatkannya di lokasi yang ditentukan oleh pdwResult.
Metode IPrintOemUni::DownloadCharGlyph ini bersifat opsional. Jika plug-in penyajian mengimplementasikan metode ini, metode IPrintOemUni::GetImplementedMethod plug-in harus mengembalikan S_OK ketika menerima "DownloadCharGlyph" sebagai input.

Jika Anda menerapkan metode , IPrintOemUni::DownloadCharGlyph Anda juga harus menerapkan metode IPrintOemUni::D ownloadFontHeader .

Untuk informasi tambahan lihat Manajemen Font yang Dikustomisasi.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header prcomoem.h (termasuk Prcomoem.h)