ID2D1Device1::SetRenderingPriority メソッド (d2d1_2.h)

デバイスに関連付けられているデバイス コンテキストで実行される Direct2D レンダリング操作の優先順位を設定します。

構文

void SetRenderingPriority(
  D2D1_RENDERING_PRIORITY renderingPriority
);

パラメーター

renderingPriority

種類: D2D1_RENDERING_PRIORITY

デバイスと関連するコンテキストに必要なレンダリング優先度。

戻り値

型: HRESULT

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

HRESULT	説明
S_OK	エラーは発生していません。
E_OUTOFMEMORY	Direct2D は、呼び出しを完了するのに十分なメモリを割り当てませんでした。
E_INVALIDARG	無効なパラメーターが返される関数に渡されました。

解説

このメソッドを呼び出すと、デバイスに関連付けられているすべてのデバイス コンテキストのレンダリング優先度に影響します。 このメソッドはいつでも呼び出すことができますが、次のフレームの先頭まで有効になるとは限りません。 推奨される使用方法は、 BeginDraw ブロックと EndDraw ブロックの外部でこのメソッドを呼び出す方法です。 描画ブロック内でこのプロパティを頻繁に循環すると、適用される調整の利点が効果的に軽減されます。

要件

サポートされている最小のクライアント	Windows 8.1 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2012 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	d2d1_2.h
Library	D2d1.lib
[DLL]	D2d1.dll

関連項目

ID2D1Device1