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 を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10バージョン 1607 (WDDM 2.1) |
| 対象プラットフォーム | Windows |
| ヘッダー | d3dkmddi.h |
| IRQL | <= PASSIVE_LEVEL |