IXpsRasterizationFactory::CreateRasterizer メソッド (xpsrassvc.h)

  • [アーティクル]

CreateRasterize メソッドは、XPS ラスタライザー オブジェクトを作成します。

構文

HRESULT CreateRasterizer(
  [in, optional]  IXpsOMPage            *xpsPage,
  [in]            FLOAT                 DPI,
  [in]            XPSRAS_RENDERING_MODE nonTextRenderingMode,
  [in]            XPSRAS_RENDERING_MODE textRenderingMode,
  [out, optional] IXpsRasterizer        **ppIXPSRasterizer
);

パラメーター

[in, optional] xpsPage

レンダリングする XPS 固定ページを表す IXpsOMPage オブジェクトへのポインター。 このオブジェクトは、XPS ドキュメントの FixedPage セクションをカプセル化します。 詳細については、「 IXpsOMPage」を参照してください。

[in] DPI

ラスター化された出力の 1 インチあたりのドット数。 このパラメーターは、出力ビットマップの x 次元と y 次元の両方に適用されます。 DPI 値は、XPS 固定ページを印刷または表示するデバイスの解像度です。

[in] nonTextRenderingMode

ラスター化された出力内の非テキスト アイテムのレンダリング モード。 このパラメーターは、アンチエイリアス出力を生成するかどうかを示します。 このパラメーターを、次のいずれかのXPSRAS_RENDERING_MODE列挙値 に 設定します。

  • XPSRAS_RENDERING_MODE_ANTIALIASED

  • XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

ラスター化された出力内のテキストのレンダリング モード。 このパラメーターは、アンチエイリアス出力を生成するかどうかを示します。 このパラメーターを、次のいずれかのXPSRAS_RENDERING_MODE列挙値に設定します。

  • XPSRAS_RENDERING_MODE_ANTIALIASED

  • XPSRAS_RENDERING_MODE_ALIASED

[out, optional] ppIXPSRasterizer

このパラメーターは、新しく作成された XPS ラスタライザー オブジェクトの IXpsRasterizer インターフェイスへのポインターをメソッドが書き込む場所を指します。 メソッドが失敗した場合、この場所に NULL を 書き込み、エラー コードを返します。

戻り値

CreateRasterizer は 、呼び出しが成功した場合にS_OKを返します。 それ以外の場合、メソッドはエラー コードを返します。

考えられるエラーの戻り値は次のとおりです。

リターン コード 説明
E_POINTER パラメーター xpsPage または ppIXPSRasterizer が NULL です
E_INVALIDARG パラメーター nonTextRenderingMode または textRenderingMode は、有効なXPSRAS_RENDERING_MODE列挙値ではありません。
E_OUTOFMEMORY メモリ不足

注釈

このメソッドは、Windows 7 以降でサポートされています。

通常、XPS パイプラインの XPSDrv フィルターは、このメソッドを呼び出して XPS ラスタライザーを取得します。 次に、ラスタライザーを使用して、パラメーター xpsPage が指すオブジェクトによってカプセル化された XPS 固定ページをラスター化します。

パラメーター DPI はプリンターの解像度を指定します。プリンターの解像度は、水平方向と垂直方向の両方の寸法で同じであると見なされます。 IXpsOMPage::GetPageDimensions メソッドから取得できる XPS 固定ページの幅と高さは、1/96 インチ単位で表されます。 これらの幅と高さの値に DPI/96 を乗算して、ラスター化されたページの幅と高さをピクセル単位で決定します。 IXpsOMPage::GetPageDimensions の詳細については、「IXpsOMPage」を参照してください。 XPS ラスタライザー オブジェクトが DPI 値を使用する方法の詳細については、「 IXpsRasterizer::RasterizeRect」を参照してください。

成功した場合、メソッドは XPS ラスタライザー オブジェクトを作成し、オブジェクトの IXpsRasterizer インターフェイスへのカウントされた参照を呼び出し元に渡します。 オブジェクトが不要になった場合、呼び出し元はオブジェクトの IXpsRasterizer インターフェイスで Release メソッドを呼び出すことによって、オブジェクトを解放する必要があります。

メソッドが失敗し、 ppIXPSRasterizer が NULL 以外の場合、メソッドは *ppIXPSRasterizer = NULL を設定します。

CreateRasterizer メソッドを呼び出すコード例については、WDK の XPSRasFilter サンプルを参照してください。 このサンプルは、WDK インストールの Src\Print\Xpsrasfilter フォルダーにあります。

要件

要件 値
サポートされている最小のクライアント Windows 7 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム デスクトップ
Header xpsrassvc.h

こちらもご覧ください

IXpsRasterizationFactory

IXpsRasterizer

IXpsRasterizer::RasterizeRect

XPSRAS_RENDERING_MODE