次の方法で共有

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT コールバック関数 (d3dkmddi.h)

  • [アーティクル]

新しいマルチプレーン オーバーレイ構成が有効になった後に呼び出され、ドライバーがハードウェアの状態を最適化できるようになります。 マルチプレーン オーバーレイをサポートする Windows ディスプレイ ドライバー モデル (WDDM) 2.0 以降のドライバーの場合は省略可能です。

構文

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT DxgkddiPostmultiplaneoverlaypresent;

NTSTATUS DxgkddiPostmultiplaneoverlaypresent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_POSTMULTIPLANEOVERLAYPRESENT pPostPresent
)
{...}

パラメーター

hAdapter

オーバーレイ ハードウェアを含むアダプターを識別します。

pPostPresent

最近コミットされた新しいオーバーレイ構成を記述する DXGKARG_POSTMULTIPLANEOVERLAYPRESENT 構造体へのポインター。

戻り値

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT は次の値を返します。

リターン コード 形容
STATUS_SUCCESS ルーチンが正常に完了した場合。 ドライバーは常に成功コードを返す必要があります。 失敗するとバグチェックが発生します。

備考

この関数はパッシブ レベルから呼び出されます。

この関数は、ドライバーが VSYNC コールバックの DXGKARGCB_NOTIFY_INTERRUPT_DATA 構造体のメンバー DXGKCB_NOTIFY_MPO_VSYNC_FLAGS PostPresentNeeded を設定する場合にのみ呼び出されます。

この機能を使用して、電圧レベル、クロック、FIFO 深度、または電力を節約できるその他の最適化を行うことができます。

呼び出しによってメイン GPU スケジューラ スレッドがブロックされ、遅延が原因で障害が発生する可能性があるため、ドライバーはこの呼び出しにかなりの時間を費やすべきではありません。 時間のかかるアクションは、ドライバーごとに個別の作業項目としてキューに入れ、バックグラウンドで処理する必要があります。 このシナリオでは、キューに置かれた項目と、将来の事前/事後呼び出しによって要求されるハードウェア変更の間の競合は、ドライバーによって管理する必要があります。

必要条件

要件 価値
ターゲット プラットフォーム の ウィンドウズ
ヘッダー d3dkmddi.h