共用方式為

IPrintOemDriverUI：:D rvGetDriverSetting 方法 (prcomoem.h)

  • 發行項

方法 IPrintOemDriverUI::DrvGetDriverSetting 是由 Unidrv 和 Pscript5 迷你驅動程式提供，讓使用者介面外掛程式可以取得印表機功能和其他內部資訊的目前狀態。

語法

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

參數

pci

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

Feature

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

pOutput

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

cbSize

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

pcbNeeded

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

pdwOptionsReturned

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

傳回值

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

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

備註

呼叫 IPrintOemDriverUI::DrvGetDriverSetting 方法時，使用者介面外掛程式可以指定字串指標或 pFeatureKeyword 的常數值。

  • 如果 pFeatureKeyword 是字串，它必須代表下列其中一項：
    • Unidrv minidriver GPD 檔案中指定的功能名稱，或
    • Pscript5 迷你驅動程式 PPD 檔案中 *OpenUI 項目的關鍵詞自變數。

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

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

規格需求

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