IPrintOemUni::D riverDMS 方法 (prcomoem.h)

方法 IPrintOemUni::DriverDMS 可讓 Unidrv 的轉譯外掛程式指出它使用裝置管理的繪圖介面。

語法

HRESULT DriverDMS(
  PVOID  pDevObj,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

參數

pDevObj

呼叫端提供的 DEVOBJ 結構的指標。

pBuffer

呼叫端提供的緩衝區指標,以接收方法指定的旗標。 (請參閱下列一節。)

cbSize

呼叫端提供的大小,以位元組為單位,由 pBuffer指向的緩衝區。

pcbNeeded

呼叫端提供的位置指標,以接收所需的 最小 pBuffer 大小。

傳回值

方法必須傳回下列其中一個值。

傳回碼 描述
S_OK
作業成功。
E_FAIL
作業失敗

備註

Unidrv 的轉譯外掛程式必須實 IPrintOemUni::DriverDMS 作 方法。 只有在 Unidrv 找到 OEM 轉譯外掛程式的有效介面指標時,才會呼叫 方法。

方法 IPrintOemUni::DriverDMS 可讓轉譯外掛程式指出它將使用裝置管理的繪圖介面,而不是預設的 GDI 管理介面。

方法必須在 pBuffer指向的緩衝區中指定HOOK_前置旗標,指出要針對繪圖介面呼叫哪一個外掛程式圖形 DDI 勾點函式。 HOOK_前置旗標是在 winddi.h 中定義,並在 EngAssociateSurface 函式的描述中描述。 所 IPrintOemUni::DriverDMS 指定的旗標會由 Unidrv 傳遞至 EngAssociateSurface。 (請注意,若要支援裝置管理的介面,轉譯外掛程式必須連結所有繪圖函式。) 如需詳細資訊,請參閱 處理Device-Managed介面

如果在 IPrintOemUni::DriverDMSpBuffer指向的緩衝區中設定旗標,Unidrv 會呼叫 EngCreateDeviceSurface來建立裝置管理的介面。 如果未 IPrintOemUni::DriverDMS 設定任何旗標,Unidrv 會呼叫 EngCreateBitmap來建立 GDI 管理的介面。 在上述任一情況下, IPrintOemUni::DriverDMS 應該會傳回S_OK。

如果 cbSize 指定的輸出緩衝區大小太小,方法應該在 由 (ERROR_INSUFFICIENT_BUFFER) 呼叫 SetLastError 的位置指定所需的大小,並傳回E_FAIL。

規格需求

   
目標平臺 桌面
標頭 prcomoem.h (包含 Prcomoem.h)