IPrintOemUni：：EnableDriver 方法 (prcomoem.h)

IPrintOemUni：：EnableDriver 方法允许 Unidrv 的呈现插件挂接某些图形 DDI 函数。

语法

HRESULT EnableDriver(
  DWORD          DriverVersion,
  DWORD          cbSize,
  PDRVENABLEDATA pded
);

参数

DriverVersion

调用方提供的接口版本号。 此值由 printoem.h 中的 PRINTER_OEMINTF_VERSION 定义。

cbSize

由 pded 指向的结构的调用方提供的大小（以字节为单位）。

pded

调用方提供的指向 DRVENABLEDATA 结构的指针。

返回值

方法必须返回以下值之一。

返回代码	说明
S_OK	操作成功。
E_FAIL	操作失败

注解

Unidrv 的呈现插件必须实现 IPrintOemUni：：EnableDriver 方法。

IPrintOemUni：：EnableDriver 方法允许呈现插件执行与打印机图形 DLL 导出的 DrvEnableDriver 函数相同的操作类型。

与 DrvEnableDriver 函数一样， IPrintOemUni：：EnableDriver 方法负责提供内部支持的图形 DDI 函数（称为挂钩函数）的地址。 它还可以执行其他一次性初始化操作。 与 DrvEnableDriver 函数不同， IPrintOemUni：：EnableDriver 的实现是可选的。

如果实现 IPrintOemUni：：EnableDriver，还必须实现 IPrintOemUni：:D isableDriver。 在前一个方法中开始的操作可能需要在后一个方法中完成。 例如，如果在 IPrintOemUni：：EnableDriver 中分配了较大的缓冲区，但在 IPrintOemUni：:D isableDriver 中未解除分配，则可能发生内存泄漏。

方法应填充提供的 DRVENABLEDATA 结构并分配 DRVFN 结构的数组。 它应使用指向挂钩函数的指针以及用于标识挂钩图形 DDI 函数的 winddi.h 定义的索引值填充数组。

仅当 Unidrv 驱动程序定义该函数时，Unidrv 的呈现插件才能挂出图形 DDI 函数。 下图 DDI 函数在 Unidrv 和/或 Pscript5 中定义，因此可以挂钩：

• DrvAlphaBlend

• DrvBitBlt

• DrvCopyBits

• DrvDitherColor

• DrvEndDoc

• DrvEscape

• DrvFillPath

• DrvFontManagement

• DrvGetGlyphMode

• DrvGradientFill

• DrvIcmCreateColorTransform

• DrvIcmDeleteColorTransform

• DrvLineTo

• DrvNextBand

• DrvPlgBlt

• DrvQueryAdvanceWidths

• DrvQueryDeviceSupport

• DrvQueryFont

• DrvQueryFontData

• DrvQueryFontTree

• DrvRealizeBrush

• DrvSendPage

• DrvStartBanding

• DrvStartDoc

• DrvStartPage

• DrvStretchBlt

• DrvStretchBltROP

• DrvStrokeAndFillPath

• DrvStrokePath

• DrvTextOut

• DrvTransparentBlt

如果提供自定义挂钩函数，它会抢占驱动程序的等效图形 DDI 函数。 挂钩函数还可以调用回驱动程序的图形 DDI 函数。 有关详细信息，请参阅 自定义图形 DDI 函数。

自定义挂钩函数具有与等效图形 DDI 函数相同的输入和输出参数，但有一个例外 - 其中图形 DDI 函数接收 PDEV 指针，自定义挂钩函数接收 DEVOBJ 指针。 图形 DDI 函数可通过两种方式接收 PDEV 指针：

• 作为目标图面的 SURFOBJ 结构的 dhpdev 成员的内容。 对于等效的自定义挂钩函数，目标 SURFOBJ 结构的 dhpdev 成员指向 DEVOBJ 结构，并且必须在引用时转换为 PDEVOBJ 类型。 一个示例图形 DDI 函数是 DrvBitBlt。

• 作为 dhpdev 参数的输入参数。 当引用 PDEVOBJ 时，等效的自定义挂钩函数必须将此输入参数强制转换为类型 PDEVOBJ。 一个示例图形 DDI 函数是 DrvDitherColor。

请注意，虽然 打印机图形 DLL 在 DRVENABLEDATA 结构中包含其 DrvEnablePDEV、 DrvDisablePDEV 和 DrvResetPDEV 函数的地址，但呈现插件会显式导出 EnablePDEV、 DisablePDEV 和 ResetPDEV 作为 IPrintOemUni 接口的方法，并且不会将其地址放在 DRVENABLEDATA 结构中。

如果 IPrintOemUni：：EnableDriver 方法由多个呈现插件导出，则按照为安装指定插件的顺序调用这些方法。

每个图形 DDI 函数只能由一个呈现插件挂钩。 如果多个插件尝试挂接相同的图形 DDI 函数，则忽略第一个插件之后的所有挂钩。

有关创建和安装呈现插件的详细信息，请参阅 自定义 Microsoft 的打印机驱动程序。

要求

要求	值
目标平台	桌面
标头	prcomoem.h (包括 Prcomoem.h)