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 エントリに対するキーワード (keyword)引数。

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

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

要件

要件 値
対象プラットフォーム デスクトップ
Header prcomoem.h (Prcomoem.h を含む)