Fungsi DrvSplDeviceCaps (winddiui.h)

Artikel
02/27/2024

Fungsi DrvSplDeviceCaps antarmuka printer DLL meminta printer untuk kemampuannya.

Sintaks

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

Parameter

hPrinter

Handel yang disediakan penelepon ke pencetak.

[in] pszDeviceName

Penunjuk yang disediakan penelepon ke string Unicode yang berisi nama printer.

Capability

Bendera bit yang disediakan penelepon yang menunjukkan kemampuan untuk mengkueri. (Bendera ditentukan dalam file header wingdi.h.) Fungsi ini tidak diperlukan untuk mendukung semua bendera DC_XXX , tetapi harus mendukung bendera yang tercantum dalam tabel berikut.

Bendera	Definisi
DC_MEDIAREADY	Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array buffer string, masing-masing 64 karakter. Setiap elemen array harus berisi string yang dihentikan NULL yang mewakili nama untuk formulir kertas yang tersedia untuk digunakan. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutput adalah NULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.
DC_PAPERNAMES	Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array buffer string, masing-masing 64 karakter. Setiap elemen array harus berisi string yang dihentikan NULL yang mewakili nama untuk formulir kertas. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutput adalah NULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.

Bendera

Definisi

DC_MEDIAREADY

Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array buffer string, masing-masing 64 karakter. Setiap elemen array harus berisi string yang dihentikan NULL yang mewakili nama untuk formulir kertas yang tersedia untuk digunakan. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutput adalah NULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.

DC_PAPERNAMES

Parameter pOutput menunjuk ke buffer yang harus diisi fungsi dengan array buffer string, masing-masing 64 karakter. Setiap elemen array harus berisi string yang dihentikan NULL yang mewakili nama untuk formulir kertas. Nilai pengembalian fungsi harus berupa jumlah elemen dalam array yang dikembalikan. Jika pOutput adalah NULL, fungsi seharusnya hanya mengembalikan jumlah elemen array yang diperlukan.

[out, optional] pOutput

Penunjuk yang disediakan penelepon ke buffer yang menerima informasi yang disediakan fungsi. Penggunaan buffer tergantung pada nilai parameter Kemampuan . Pemanggil bertanggung jawab untuk mengalokasikan dan membebaskan buffer ini.

cchBufSize

Ukuran yang disediakan pemanggil (dalam karakter) dari buffer yang diacu oleh parameter pOutput .

[in, optional] pDevmode

Penunjuk yang disediakan penelepon ke struktur DEVMODEW yang menjelaskan karakteristik pekerjaan cetak saat ini. Jika NULL, fungsi harus menggunakan struktur DEVMODEW default internal driver.

Mengembalikan nilai

Nilai yang dikembalikan tergantung pada parameter Kapabilitas . Jika Kemampuan menunjukkan kemampuan yang tidak didukung driver, atau jika terjadi kesalahan, fungsi harus mengembalikan GDI_ERROR.

Keterangan

Untuk deskripsi bendera DC_XXX , lihat DrvDeviceCapabilities.

Fungsi ini harus didefinisikan dalam file .def sebagai DrvSplDeviceCaps @ 254, karena penampung menggunakan nomor urut 254 untuk mendapatkan penunjuk fungsi driver.

Persyaratan

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

Lihat juga

DrvDeviceCapabilities

Bagikan melalui