IPrintOemUni::Metode CommandCallback (prcomoem.h)

  • Artikel

Metode IPrintOemUni::CommandCallback ini digunakan untuk menyediakan perintah printer yang dihasilkan secara dinamis untuk printer yang didukung Unidrv.

Sintaks

HRESULT CommandCallback(
        PDEVOBJ pdevobj,
        DWORD   dwCallbackID,
        DWORD   dwCount,
        PDWORD  pdwParams,
  [out] OUT INT *piResult
);

Parameter

pdevobj

Penunjuk yang disediakan penelepon ke struktur DEVOBJ .

dwCallbackID

Nilai yang disediakan penelepon mewakili atribut *CallbackID perintah printer dalam file GPD printer. (Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.)

dwCount

Nilai yang disediakan penelepon mewakili jumlah elemen dalam array yang ditunjukkan oleh pdwParams. Bisa 0.

pdwParams

Penunjuk yang disediakan penelepon ke array parameter berukuran DWORD yang berisi nilai yang ditentukan oleh perintah printer *Atribut params dalam file GPD printer. (Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.) Bisa NULL.

[out] piResult

Menerima nilai hasil yang disediakan metode. Lihat bagian Keterangan berikut ini.

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::CommandCallback ini digunakan dengan merender plug-in untuk menghasilkan perintah printer secara dinamis, untuk printer yang didukung oleh Unidrv.

Jika Anda ingin membuat perintah printer secara dinamis, Anda harus menyertakan atribut *CallbackID dan, secara opsional, atribut *Params , dalam perintah *Entri perintah dalam file GPD printer. Untuk informasi selengkapnya, lihat Perintah Printer yang Dihasilkan Secara Dinamis.

Saat Unidrv memanggil IPrintOemUni::CommandCallback metode , Unidrv menyediakan *Nilai atribut CallbackID entri *Perintah sebagai parameter dwCallbackID . Ini juga menempatkan nilai atribut *Params entri perintah di dalam array DWORD dan memasok alamat array sebagai parameter pParams . Array berisi sekumpulan nilai variabel standar yang ditentukan Unidrv, dan parameter dwCount menentukan jumlah parameter yang terkandung dalam array. Untuk informasi selengkapnya tentang atribut, lihat Atribut Perintah.

Metode harus menggunakan nilai parameter dwCallbackID untuk menentukan perintah mana yang akan diproses. Untuk setiap perintah yang didukung, metode harus mengetahui variabel standar yang mana, jika ada, telah ditentukan oleh atribut *Params entri perintah, dan dalam urutan mana.

Metode ini bertanggung jawab untuk membangun perintah printer, lalu mengirim perintah ke penampung cetak dengan memanggil metode IPrintOemDriverUni::D rvWriteSpoolBuf .

Nilai yang disediakan untuk piResult harus selalu mengembalikan nol kecuali metode memproses perintah kursor. Untuk perintah kursor yang memindahkan kursor ke x atau arah, metode harus mengembalikan posisi kursor baru.

Metode IPrintOemUni::CommandCallback ini bersifat opsional. Jika plug-in penyajian mengimplementasikan metode ini, metode IPrintOemUni::GetImplementedMethod plug-in harus mengembalikan S_OK ketika menerima "CommandCallback" sebagai input.

Persyaratan

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