Bagikan melalui

Fungsi DrvDeviceCapabilities (winddiui.h)

  • Artikel

Fungsi DrvDeviceCapabilities antarmuka printer DLL mengembalikan informasi yang diminta tentang kemampuan printer.

Sintaks

DWORD DrvDeviceCapabilities(
                 HANDLE   hPrinter,
  [in]           PWSTR    pszDeviceName,
                 WORD     Capability,
  [out]          PVOID    pOutput,
  [in, optional] PDEVMODE pDevmode
);

Parameter

hPrinter

Handel printer yang disediakan penelepon.

[in] pszDeviceName

Penunjuk yang disediakan penelepon ke string nama printer.

Capability

Bendera bit yang disediakan penelepon menunjukkan informasi yang diminta. Ini bisa menjadi salah satu bendera yang tercantum dalam tabel berikut. (Bendera ditentukan dalam file header Wingdi.h.)

Bendera Definisi
DC_BINADJUST Tidak digunakan untuk sistem operasi berbasis NT.
DC_BINNAMES Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array buffer string, masing-masing panjangnya 24 karakter. Setiap buffer string dalam array harus berisi string karakter lebar yang dihentikan NULL yang menentukan nama bin sumber kertas. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutputNULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.
DC_BINS Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array WORD. Setiap elemen array harus berisi konstanta berawalan DMBIN (atau nilai yang disesuaikan) yang mewakili bin sumber kertas yang didukung. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutputNULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.
DC_COLLATE Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus 1 jika printer mendukung kolase; jika tidak, nilai yang dikembalikan harus nol.
DC_COLORDEVICE Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus 1 jika printer mendukung pencetakan warna; jika tidak, nilai yang dikembalikan harus nol.
DC_COPIES Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus berupa jumlah maksimum salinan yang dapat didukung printer.
DC_DATATYPE_PRODUCED Tidak digunakan untuk sistem operasi berbasis NT.
DC_DRIVER Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus menjadi anggota dmDriverVersion dari struktur internal driver [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew).
DC_DUPLEX Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus 1 jika printer mendukung pencetakan dupleks; jika tidak, nilai yang dikembalikan harus nol.
DC_EMF_COMPLIANT Tidak digunakan untuk sistem operasi berbasis NT.
DC_ENUMRESOLUTIONS Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array LONG. Untuk setiap resolusi yang didukung oleh printer, fungsi harus mengembalikan dua kata panjang (satu untuk dimensi x dan satu untuk dimensi y ) resolusi, dalam titik per inci. Nilai pengembalian fungsi harus berupa jumlah resolusi yang didukung. Jika pOutputNULL, fungsi seharusnya hanya mengembalikan jumlah resolusi yang didukung.
DC_EXTRA Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus menjadi anggota dmDriverExtra dari struktur internal driver [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew).
DC_FIELDS Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus menjadi anggota dmFields dari struktur internal driver [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew). Anggota dmFields menunjukkan anggota mana dalam bagian independen perangkat dari struktur DEVMODEW yang didukung oleh driver printer.
DC_FILEDEPENDENCIES Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array buffer string, masing-masing 64 karakter. Setiap buffer string dalam array harus berisi string karakter lebar yang dihentikan NULL yang menentukan nama file yang harus diinstal dengan driver. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutputNULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.
DC_MANUFACTURER Tidak digunakan untuk sistem operasi berbasis NT.
DC_MAXEXTENT Parameter pOutput tidak digunakan. Fungsi harus mengembalikan struktur POINTS (dijelaskan dalam dokumentasi Microsoft Windows SDK). Struktur harus berisi nilai maksimum yang diizinkan untuk anggota dmPaperWidth (dimensi x ) dan dmPaperLength (dimensi y ) dari struktur DEVMODEW printer.
DC_MEDIAREADY Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array buffer string, masing-masing 64 karakter. Setiap buffer string dalam array harus berisi string karakter lebar yang dihentikan NULL yang menentukan nama formulir kertas yang tersedia untuk digunakan. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutputNULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.
DC_MEDIATYPENAMES Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array buffer string, masing-masing 64 karakter. Setiap buffer string dalam array harus berisi string yang dihentikan NULL berkarakter lebar yang menentukan nama jenis media yang didukung. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutputNULL, fungsi hanya harus mengembalikan jumlah elemen array yang diperlukan.
DC_MEDIATYPES Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array DWORD. Setiap elemen array harus berisi konstanta berawalan DMMEDIA (lihat struktur [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew) atau nilai yang disesuaikan mewakili jenis media yang didukung. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutputNULL, fungsi hanya harus mengembalikan jumlah elemen array yang diperlukan.
DC_MINEXTENT Parameter pOutput tidak digunakan. Fungsi harus mengembalikan struktur POINTS (dijelaskan dalam dokumentasi Windows SDK). Struktur harus berisi nilai minimum yang diizinkan untuk anggota dmPaperWidth (x dimensi) dan dmPaperLength (dimensi y ) dari struktur DEVMODEW printer.
DC_MODEL Tidak digunakan untuk sistem operasi berbasis NT.
DC_NUP Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array DWORD. Setiap elemen array harus berisi bilangan bulat yang mewakili opsi N-up (yaitu, setiap bilangan bulat harus mewakili jumlah halaman dokumen yang didukung per halaman fisik). Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutputNULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.
DC_ORIENTATION Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus berupa jumlah derajat rotasi yang diperlukan untuk menghasilkan orientasi lanskap dari orientasi potret. Nilai nol menunjukkan orientasi lanskap tidak didukung.
DC_PAPERNAMES Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array buffer string, masing-masing 64 karakter. Setiap buffer string dalam array harus berisi string karakter lebar yang dihentikan NULL yang menentukan nama formulir kertas. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutputNULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.
DC_PAPERS Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array WORD. Setiap elemen array harus berisi konstanta berawalan DMPAPER (atau nilai yang disesuaikan) yang mewakili bentuk kertas yang didukung. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutputNULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.
DC_PAPERSIZE Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array POINT. Setiap elemen array harus berisi dimensi x dan y dari ukuran kertas formulir, dalam unit 0,1 mm, dalam orientasi potret. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutputNULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.
DC_PERSONALITY Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array buffer string, masing-masing 32 karakter. Setiap buffer string dalam array harus berisi string karakter lebar yang dihentikan NULL yang menentukan bahasa deskripsi printer yang didukung oleh printer (misalnya, L"HP-GL/2"). Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutputNULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.
DC_PRINTERMEM Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus berupa bilangan bulat yang mewakili jumlah memori printer yang tersedia, dalam kilobyte.
DC_PRINTRATE Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus berupa bilangan bulat yang mewakili laju cetak, dalam unit yang ditentukan untuk DC_PRINTRATEUNIT.
DC_PRINTRATEPPM Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus berupa bilangan bulat yang mewakili laju cetak, dalam halaman per menit.
DC_PRINTRATEUNIT Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus mengidentifikasi unit yang digunakan untuk menentukan nilai yang dikembalikan untuk DC_PRINTRATE. Salah satu konstanta berikut harus ditentukan: PRINTRATEUNIT_PPM - pages/min. PRINTRATEUNIT_CPS - chars./detik. PRINTRATEUNIT_LPM - lines/min. PRINTRATEUNIT_IPM - inci/menit.
DC_SIZE Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus menjadi anggota dmSize dari struktur internal driver [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew).
DC_STAPLE Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus TRUE jika printer mendukung stapling, dan FALSE jika printer tidak mendukung stapling.
DC_TRUETYPE Parameter pOutput tidak digunakan. Nilai pengembalian fungsi bisa nol, satu, atau lebih dari bendera berikut: DCTT_BITMAP: Perangkat dapat mencetak font TrueType sebagai grafik. DCTT_DOWNLOAD: Perangkat dapat menerima font TrueType yang diunduh. DCTT_DOWNLOAD_OUTLINE: (Hanya Windows 95/98/Me) Perangkat dapat mengunduh kerangka font TrueType. DCTT_SUBDEV: Perangkat dapat mengganti font perangkat untuk font TrueType.
DC_VERSION Parameter pOutput tidak digunakan. Nilai pengembalian fungsi harus menjadi anggota dmSpecVersion dari struktur internal driver [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew).

[out] pOutput

Penunjuk yang disediakan penelepon ke buffer untuk menerima informasi yang disediakan fungsi. Penggunaan buffer tergantung pada nilai yang diterima untuk parameter Kapabilitas .

[in, optional] pDevmode

Penunjuk yang disediakan penelepon ke struktur DEVMODEW yang menjelaskan karakteristik pekerjaan cetak saat ini. Jika parameter ini NULL, DrvDeviceCapabilities mengambil nilai inisialisasi default saat ini untuk driver printer yang ditentukan, seperti struktur DEVMODEW default pengguna dari antrean cetak.

Mengembalikan nilai

Nilai pengembalian fungsi tergantung pada nilai yang diterima untuk parameter Kapabilitas . Jika nilai Kemampuan yang diterima mewakili kemampuan yang tidak didukung driver, atau jika terjadi kesalahan, fungsi harus mengembalikan GDI_ERROR.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header winddiui.h (termasuk Winddiui.h)