IPrintOemDriverUni::D rvGetGPDData メソッド (prcomoem.h)

  • [アーティクル]

メソッドは IPrintOemDriverUni::DrvGetGPDData 、レンダリング プラグインがプリンターの GPD ファイルで定義されているデータを取得できるように、Unidrv ドライバーによって提供されます。

構文

HRESULT DrvGetGPDData(
  PDEVOBJ pdevobj,
  DWORD   dwType,
  PVOID   pInputData,
  PVOID   pBuffer,
  DWORD   cbSize,
  PDWORD  pcbNeeded
);

パラメーター

pdevobj

呼び出し元が指定した DEVOBJ 構造体へのポインター。

dwType

要求される GPD データの種類を示す呼び出し元から指定されたフラグ。 現時点では、次のフラグのみが定義されています。

フラグ 定義
GPD_OEMCUSTOMDATA メソッドは、GPD ファイルの *OEMCustomData エントリに関連付けられている文字列を返します。

pInputData

予約済み。 ゼロを指定してください。

pBuffer

要求された情報を受け取るバッファーへの呼び出し元指定ポインター。

cbSize

pBuffer が指すバッファーの呼び出し元が指定したサイズ (バイト単位)。

pcbNeeded

要求された情報を格納するために必要な、ドライバーが提供する最小バッファー サイズ (バイト単位) を受け取ります。

戻り値

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

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

注釈

pBuffer および cbSize で指定されたバッファーが小さすぎて要求された情報を受け取れない場合、Unidrv は pcbNeeded が指す場所に必要なバッファー サイズを指定し、E_FAILを返し、エラー コードを ERROR_INSUFFICIENT_BUFFERに設定します。

要件

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