PFND3DWDDM2_0DDI_SETHARDWAREPROTECTION コールバック関数 (d3d10umddi.h)

  • [アーティクル]

SetHardwareProtection を使用すると、デスクトップ ウィンドウ マネージャー (DWM) の全画面表示スワップ チェーン バッファーを、再作成することなく、保護された状態と保護されていない状態の間で転送できます。

構文

PFND3DWDDM2_0DDI_SETHARDWAREPROTECTION Pfnd3dwddm20DdiSethardwareprotection;

void Pfnd3dwddm20DdiSethardwareprotection(
  D3D10DDI_HDEVICE hDevice,
  D3D10DDI_HRESOURCE hResource,
  BOOL Protected
)
{...}

パラメーター

hDevice

ディスプレイ デバイス (グラフィックス コンテキスト) へのハンドル。 Direct3D ランタイムは、ユーザー モード ドライバーにこのハンドルを、デバイスの作成時にD3DDDIARG_CREATEDEVICE構造体の hDevice メンバーとして渡しました。

hResource

CreateResourceDDI の呼び出しによって作成されたリソース オブジェクトへのハンドル。

Protected

バッファーを保護する必要があることを示します。

戻り値

なし

解説

DWM スワップ チェーン バッファーの破棄と再作成は、一部のハードウェアで回避できる重い操作です。 この DDI は、ドライバーが D3DWDDM2_0DDI_CONTENT_PROTECTION_CAPS_HARDWARE_PROTECTED_MEMORY_TRANSITION 機能を報告する場合にのみ呼び出されます。 これが設定されていない場合、基になる DWM スワップ チェーンの割り当ては破棄され、再作成されます。

SetHardwareProtection は、非表示のスワップ チェーン バッファーで呼び出され、ビジュアル成果物を発生させることなく、保護モードと保護されていないモードの間で切り替えることができます。 DWM が新しく変更されたバッファーに反転すると、DWM はスワップ チェーン バッファー内の次のバッファーで SetHardwareProtection を呼び出し、新しい保護状態が各スワップ チェーン バッファーに設定されるまで呼び出します。

メモ DWM は、ハードウェア保護状態が変更された後にスワップ チェーン バッファー全体を再レンダリングすることが保証されます。
 

要件

要件 値
サポートされている最小のクライアント Windows 10
サポートされている最小のサーバー Windows Server 2016
対象プラットフォーム デスクトップ
Header d3d10umddi.h (D3d10umddi.h を含む)

こちらもご覧ください

CreateResource

D3DDDIARG_CREATEDEVICE