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 スケジューラ スレッドメインがブロックされ、遅延が原因で不具合が発生する可能性があるためです。 時間のかかるアクションは、ドライバーごとに個別の作業項目としてキューに登録し、バックグラウンドで処理する必要があります。 このシナリオでは、キューに登録された項目と、将来の事前/事後呼び出しによって要求されるハードウェア変更との間で競合が発生した場合は、ドライバーによって管理する必要があります。

要件

要件 値
対象プラットフォーム Windows
ヘッダー d3dkmddi.h