IPrintOemUni::EnablePDEV-Methode (prcomoem.h)

Artikel
02/07/2025

Mit der IPrintOemUni::EnablePDEV-Methode kann ein Rendering-Plug-In für Unidrv eine eigene PDEV-Struktur erstellen.

Syntax

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

Vom Aufrufer bereitgestellter Zeiger auf eine DEVOBJ- Struktur.

pPrinterName

Vom Aufrufer bereitgestellter Zeiger auf eine Textzeichenfolge, die die logische Adresse des Druckers darstellt.

cPatterns

Vom Aufrufer bereitgestellter Wert, der die Anzahl der im Puffer enthaltenen HSURF-typierten Oberflächenziehpunkte darstellt, auf die durch phsurfPatternsverwiesen wird.

phsurfPatterns

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, der groß genug ist, um cPatterns Anzahl der HSURF-typierten Oberflächenziehpunkte zu enthalten. Die Ziehpunkte stellen Oberflächenfüllungsmuster dar.

cjGdiInfo

Vom Aufrufer bereitgestellter Wert, der die Größe der Struktur darstellt, auf die durch pGdiInfoverwiesen wird.

pGdiInfo

Vom Aufrufer bereitgestellter Zeiger auf eine GDIINFO--Struktur.

cjDevInfo

Vom Aufrufer bereitgestellter Wert, der die Größe der Struktur darstellt, auf die von pDevInfoverwiesen wird.

pDevInfo

Vom Aufrufer bereitgestellter Zeiger auf eine DEVINFO--Struktur.

pded

Vom Aufrufer bereitgestellter Zeiger auf eine DRVENABLEDATA- Struktur, die die Adressen der Grafik-DDI-Hookingfunktionen des Druckertreibers enthält. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[out] pDevOem

Empfängt einen von der Methode bereitgestellten Zeiger auf eine private PDEV-Struktur. (Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".)

Rückgabewert

Die Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Der Vorgang war erfolgreich.
E_FAIL	Fehler beim Vorgang.

Wenn der Vorgang fehlschlägt, sollte die Methode SetLastError- aufrufen, um einen Fehlercode festzulegen.

Bemerkungen

Ein Rendering-Plug-In für Unidrv muss die IPrintOemUni::EnablePDEV-Methode implementieren.

Die IPrintOemUni::EnablePDEV-Methode führt dieselben Arten von Vorgängen wie die DrvEnablePDEV--Funktion aus, die von einer Druckergrafik-DLL exportiert wird. Ziel ist es, ein Rendering-Plug-In zu ermöglichen, eine eigene PDEV-Struktur zu erstellen. (Weitere Informationen zu PDEV-Strukturen finden Sie unter Angepasste PDEV-Strukturen.)

Wenn Sie ein Rendering-Plug-In bereitstellen, das die IPrintOemUni::EnablePDEV-Methode exportiert, ruft Die Druckergrafik-DLL von Undrv die Methode innerhalb der DrvEnablePDEV--Funktion auf.

Die IPrintOemUni::EnablePDEV-Methode sollte eine Instanz der privaten PDEV-Struktur zuweisen, initialisieren und ihre Adresse als pDevOem-Parameter zurückgeben. Andere Plug-In-Methoden erhalten die Adresse als pdevOEM- Mitglied der DEVOBJ--Struktur.

Das pdevOEM Mitglied der DEVOBJ-Struktur wird nicht mit der IPrintOemUni::EnablePDEV-Methode verwendet.

Die strukturen, auf die die phsurfPatterns, pGdiInfound pDevInfo Parameterwerte verweisen, sind die gleichen wie die DrvEnablePDEV Funktion von Unidrv. Das Rendering-Plug-In kann den Strukturinhalt bei Bedarf ändern. Es kann Oberflächenfüllungsmuster liefern, indem sie HSURF-typierte Oberflächenziehpunkte abrufen und in den Puffer setzen, auf den durch phsurfPatternsverwiesen wird. Füllmustertypen und Handlereihenfolge werden in der Beschreibung von DrvEnablePDEVaufgeführt.

Die DRVENABLEDATA Struktur, auf die pded verweist, enthält die Adressen der Grafik-DDI-Funktionen, die unidrv Druckergrafik-DLL bereitgestellt. Sie dürfen benutzerdefinierte Hookingfunktionen in Ihrem Plug-In für diese Grafik-DDI-Funktionen bereitstellen. Der Inhalt der DRVENABLEDATA-Struktur ermöglicht es Ihren angepassten Hookingfunktionen, die Grafik-DDI-Funktionen des Treibers zurückzurufen. Weitere Informationen finden Sie unter Benutzerdefinierte Grafik-DDI-Funktionen.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	prcomoem.h (einschließlich Prcomoem.h)

Freigeben über