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

カーネル モードディスプレイ ミニポート ドライバーは 、現在 のマルチプレーン オーバーレイ (MPO) 構成が指定された VidPnSourceId でサポートされなくなったことを示すために、DXGKCB_MULTIPLANEOVERLAYDISABLEDを呼び出します。

構文

DXGKCB_MULTIPLANEOVERLAYDISABLED DxgkcbMultiplaneoverlaydisabled;

void DxgkcbMultiplaneoverlaydisabled(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT VidPnSourceId
)
{...}

パラメーター

[in] hAdapter

現在の MPO ハードウェア構成がサポートされなくなったアダプターへのハンドル。

[in] VidPnSourceId

現在の MPO ハードウェア構成がサポートされなくなった VidPnSourceId 。

戻り値

なし

解説

DXGKCB_MULTIPLANEOVERLAYDISABLED は、現在の MPO 構成がサポートされなくなったことをデスクトップ Windows マネージャー (DWM) に通知し、DWM がコンポジションにフォールバックできるようにします。

この要求は非同期的に処理され、複数のフレームで遅延する可能性があります。 この関数は、次のような例外的な場合にのみ呼び出することをお勧めします。

• 1 つの出力で表示変更またはホット プラグ イベントを実行すると、別のモニターにコミットされた MPO 構成を引き続きサポートできなくなります。 この場合、ドライバーはモニター上のオーバーレイ プレーンを無効にすることができます。 ユーザーには表示される成果物が表示されますが、最終的には DWM によって修正する必要があります。

• 熱の問題のために MPO を無効にする必要があります。 この場合、ドライバーは MPO をすぐに無効にする必要はありませんが、DWM が通知を受け取り、MPO のサポートが必要になるまで待機できます (これは、温度の問題のために KMD がサポートされていないことを示す必要があります)。 その時点で、DWM は MPO を無効にし、作成を開始します。

一般的なケースでは、ドライバーは、 DxgkDdiCheckMultiplaneOverlaySupport3 に正しく応答することで、互換性のないマルチプレーン オーバーレイ構成を防ぐ必要があります。

DXGKCB_XXX 関数は Dxgkrnl によって実装されます。 このコールバック関数を使用するには、DXGKRNL_INTERFACEを介して DxgkCbMultiPlaneOverlayDisabled を呼び出します。

要件

こちらもご覧ください

DxgkDdiCheckMultiplaneOverlaySupport3

DXGKRNL_INTERFACE