次の方法で共有

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 ミニドライバー GPD ファイルで指定された機能名。または、
    • Pscript5 ミニドライバーの PPD ファイルの *OpenUI エントリへのキーワード引数。

    このメソッドは、pOutput によって指されるバッファー内の 1 つ以上の NULL で終わる文字列返します。 各文字列は、現在選択されているオプションの名前を表します。pdwOptionsReturned 文字列の数が返されます。

  • pFeatureKeyword 定数の場合は、printoem.h で定義されている OEMGDS_プレフィックス付き定数のいずれかである必要があります。 このメソッドは、指定した定数によって示される値を、pOutput 指すバッファーに配置することによって返します。 pdwOptionsReturned 返される値は常に 1 です。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー prcomoem.h (Prcomoem.h を含む)