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 |