IPrintOemDriverUni::D rvGetDriverSetting 方法 (prcomoem.h)

方法 IPrintOemDriverUni::DrvGetDriverSetting 是由 Unidrv 驅動程式提供,讓轉譯外掛程式可以取得印表機功能和其他內部資訊的目前狀態。

語法

HRESULT DrvGetDriverSetting(
  PVOID  pdriverobj,
  PCSTR  Feature,
  PVOID  pOutput,
  DWORD  cbSize,
  PDWORD pcbNeeded,
  PDWORD pdwOptionsReturned
);

參數

pdriverobj

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

Feature

呼叫端提供的值,可識別將傳回選項設定的印表機功能。 這可以是字串指標或常數,如下列一節所述。

pOutput

呼叫端提供的緩衝區指標,以接收指定的資訊。

cbSize

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

pcbNeeded

呼叫端提供的位置指標,以接收包含要求資訊所需的最小緩衝區大小。

pdwOptionsReturned

呼叫端提供的位置指標,以接收放置在 pOutput 中的選項字串數目。

傳回值

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

傳回碼 描述
S_OK
作業成功。
E_FAIL
作業失敗。
E_NOTIMPL
此方法尚未實作。

備註

IPrintOemDriverUni::DrvGetDriverSetting呼叫 方法時,可以為 pFeatureKeyword 指定字串指標或常數值。

  • 如果 pFeatureKeyword 是字串,它必須代表 Unidrv minidriver GPD 檔案中指定的功能名稱

    方法應該會在 pOutput 所指向的緩衝區中傳回一或多個 NULL 終止字串。 每個字串都應該代表目前選取選項的名稱。 應該在 pdwOptionsReturned 中傳回字串數目。

  • 如果 pFeatureKeyword 是常數,它必須是 printoem.h 中定義的 OEMGDS_前置常數之一。 方法應該傳回指定常數所指示的值,方法是將它放在 pOutput 指向的緩衝區中。 pdwOptionsReturned 中傳回的值必須是 1。

規格需求

需求
目標平台 桌面
標頭 prcomoem.h (包含 Prcomoem.h)