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 がサポートされていないことを KMD が示す必要があります)。 その時点で、DWM は MPO を無効にし、作成を開始します。
一般的なケースでは、ドライバーは、代わりに DxgkDdiCheckMultiplaneOverlaySupport3 に正しく応答することで、互換性のないマルチプレーン オーバーレイ構成を防ぐ必要があります。
DXGKCB_XXX 関数は、Dxgkrnlによって実装されます。 このコールバック関数を使用するには、DXGKRNL_INTERFACE経由で DxgkCbMultiPlaneOverlayDisabled を呼び出します。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 10 バージョン 1607 (WDDM 2.1) |
ターゲット プラットフォーム の | ウィンドウズ |
ヘッダー | d3dkmddi.h |
IRQL | <= PASSIVE_LEVEL |
関連項目
dxgkDdiCheckMultiplaneOverlaySupport3 を する