IPrintOemPS::GetInfo メソッド (prcomoem.h)

  • [アーティクル]

レンダリング プラグインの IPrintOemPS::GetInfo メソッドは、識別情報を返します。

構文

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

パラメーター

dwMode

次の呼び出し元から指定された整数定数のいずれかを含みます。

OEMGI_GETPUBLISHERINFO

メソッドは、レンダリング プラグインが "発行モード" を使用するかどうかを示す必要があります。 pBuffer パラメーターは、メソッドによって入力される PUBLISHERINFO 構造体を指します。 詳細については、「解説」を参照してください。

OEMGI_GETREQUESTEDHELPERINTERFACES

IPrintOemPS::P ublishDriverInterface メソッドを呼び出し、IPrintCoreHelperPS インターフェイスを実装するオブジェクトを指すパラメーター pIUnknown を指定する場合、メソッドは、OEMPUBLISH_IPRINTCOREHELPERのビット フラグ値をバッファー pBuffer に書き込む必要があります。

OEMGI_GETSIGNATURE

メソッドは、一意の 4 バイト識別シグネチャを返す必要があります。 また、プラグインは、OEMCUIPPARAM の説明で説明されているように、この署名を OPTITEM 構造体に配置する必要があります。 構造体の pOEMOptItems メンバー。

OEMGI_GETVERSION

メソッドは、ユーザー インターフェイス プラグインのバージョン番号を DWORD として返す必要があります。 バージョン形式は開発者定義です。

pBuffer

dwMode で指定された情報を受信するために割り当てられたメモリへの呼び出し元指定ポインター。

cbSize

pBuffer が指すバッファーの呼び出し元から指定されたサイズ。

pcbNeeded

pBuffer が指すバッファーに書き込まれたバイト数を受け取る場所への呼び出し元指定ポインター。

戻り値

メソッドは、次のいずれかの値を返す必要があります。

リターン コード 説明
S_OK
 操作が成功しました。
E_FAIL
 操作に失敗しました
E_NOTIMPL
 このメソッドは実装されていません。

注釈

Pscript5 のレンダリング プラグインは、プラグインが読み込まれた直後に呼び出される メソッドを実装 IPrintOemPS::GetInfo するために必要です。 メソッドは、指定された情報を pBuffer で指定されたアドレスに書き込み、返された情報のサイズ (バイト単位) を pcbNeeded で指定された場所に書き込むことで、指定した情報を返す必要があります。

pBuffer が NULL の場合、メソッドは pcbNeeded を使用して、指定した情報を格納するために必要なバイト数を返す必要があります。

"発行モード" では、ダウンロードするすべてのフォント情報がジョブ ヘッダーに配置されます。 各フォントは 1 回だけダウンロードされ、任意のページで使用できるため、ジョブをページ順に独立させることができます。 dwMode がOEMGI_GETPUBLISHERINFOされているが、プラグインが発行モードをサポートしていない場合は、 IPrintOemPS::GetInfo E_NOTIMPLを返す必要があります。

レンダリング プラグインの作成とインストールの詳細については、「 Microsoft のプリンター ドライバーのカスタマイズ」を参照してください。

要件

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

こちらもご覧ください

IPrintOemPS

IPrintOemUI::GetInfo

IPrintOemUni::GetInfo