IPrintOemDriverPS::D rvGetDriverSetting メソッド (prcomoem.h)

  • [アーティクル]

このメソッドは IPrintOemDriverPS::DrvGetDriverSetting Pscript5 ドライバーによって提供されるため、レンダリング プラグインはプリンター機能やその他の内部情報の現在の状態を取得できます。

構文

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
 このメソッドは実装されていません。

注釈

メソッドが IPrintOemDriverPS::DrvGetDriverSetting 呼び出されると、 pFeatureKeyword に文字列ポインターまたは定数値を指定できます。

  • pFeatureKeyword が文字列の場合は、Pscript5 ミニドライバーの PPD ファイル内の *OpenUI エントリへのキーワード (keyword)引数を表す必要があります。

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

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

要件

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