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

[アーティクル]
03/05/2024

レンダリングプラグインの 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

次の方法で共有