共用方式為

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 （include Prcomoem.h）