Metode IPrintOemUni::EnablePDEV (prcomoem.h)

Metode ini IPrintOemUni::EnablePDEV memungkinkan plug-in penyajian untuk Unidrv untuk membuat struktur PDEV sendiri.

Sintaks

HRESULT EnablePDEV(
        PDEVOBJ       pdevobj,
        PWSTR         pPrinterName,
        ULONG         cPatterns,
        HSURF         *phsurfPatterns,
        ULONG         cjGdiInfo,
        GDIINFO       *pGdiInfo,
        ULONG         cjDevInfo,
        DEVINFO       *pDevInfo,
        DRVENABLEDATA *pded,
  [out] OUT PDEVOEM   *pDevOem
);

Parameter

pdevobj

Penunjuk yang disediakan penelepon ke struktur DEVOBJ .

pPrinterName

Penunjuk yang disediakan penelepon ke string teks yang mewakili alamat logis printer.

cPatterns

Nilai yang disediakan penelepon mewakili jumlah handel permukaan berjenis HSURF yang terkandung dalam buffer yang ditunjukkan oleh phsurfPatterns.

phsurfPatterns

Penunjuk yang disediakan penelepon ke buffer yang cukup besar untuk berisi jumlah cPatterns handel permukaan jenis HSURF. Handel mewakili pola isian permukaan.

cjGdiInfo

Nilai yang disediakan penelepon mewakili ukuran struktur yang ditunjukkan oleh pGdiInfo.

pGdiInfo

Penunjuk yang disediakan penelepon ke struktur GDIINFO .

cjDevInfo

Nilai yang disediakan penelepon mewakili ukuran struktur yang ditunjukkan oleh pDevInfo.

pDevInfo

Penunjuk yang disediakan penelepon ke struktur DEVINFO .

pded

Penunjuk yang disediakan penelepon ke struktur DRVENABLEDATA yang berisi alamat fungsi pengait DDI grafis driver printer. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

[out] pDevOem

Menerima pointer yang disediakan metode ke struktur PDEV privat. (Untuk informasi selengkapnya, lihat bagian Keterangan berikut.)

Nilai kembali

Metode harus mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
E_FAIL	Operasi gagal

 

Jika operasi gagal, metode harus memanggil SetLastError untuk mengatur kode kesalahan.

Keterangan

Plug-in penyajian untuk Unidrv harus menerapkan IPrintOemUni::EnablePDEV metode .

Metode ini IPrintOemUni::EnablePDEV melakukan jenis operasi yang sama dengan fungsi DrvEnablePDEV yang diekspor oleh DLL grafis printer. Tujuannya adalah untuk memungkinkan plug-in penyajian untuk membuat struktur PDEV sendiri. (Untuk informasi selengkapnya tentang struktur PDEV, lihat Struktur PDEV yang Disesuaikan.)

Jika Anda menyediakan plug-in penyajian yang mengekspor IPrintOemUni::EnablePDEV metode , DLL grafis printer Undrv memanggil metode dari dalam fungsi DrvEnablePDEV-nya .

Metode IPrintOemUni::EnablePDEV harus mengalokasikan instans struktur PDEV privatnya, menginisialisasinya, dan mengembalikan alamatnya sebagai parameter pDevOem metode. Metode plug-in lainnya menerima alamat sebagai anggota pdevOEM dari struktur DEVOBJ .

Anggota pdevOEM dari struktur DEVOBJ tidak digunakan dengan IPrintOemUni::EnablePDEV metode .

Struktur yang diacu oleh nilai parameter phsurfPatterns, pGdiInfo, dan pDevInfo adalah struktur yang sama dengan yang diterima fungsi DrvEnablePDEV Unidrv. Plug-in penyajian dapat memodifikasi konten struktur seperlunya. Ini dapat memasok pola pengisian permukaan dengan mendapatkan handel permukaan jenis HSURF dan menempatkannya di buffer yang diarahkan oleh phsurfPatterns. Jenis pola isian dan urutan penanganan tercantum dalam deskripsi DrvEnablePDEV.

Struktur DRVENABLEDATA yang ditujukkan oleh pded berisi alamat fungsi DDI grafis yang disediakan DLL grafis printer Unidrv. Anda diizinkan untuk menyediakan fungsi pengait yang disesuaikan di plug-in Anda untuk fungsi DDI grafis ini. Konten struktur DRVENABLEDATA memungkinkan fungsi kait yang disesuaikan untuk memanggil kembali ke fungsi DDI grafis driver. Untuk informasi selengkapnya, lihat Fungsi DDI Grafis yang Dikustomisasi.

Persyaratan

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