次の方法で共有

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 オペレーティング システムで使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー xpsrassvc.h

関連項目

IXpsRasterizationFactory の

IXpsRasterizer の

IXpsRasterizer::RasterizeRect

XPSRAS_RENDERING_MODE