DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 コールバック関数 (d3dkmddi.h)
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 表示されているオーバーレイ構成を変更するために呼び出されます。
構文
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3;
NTSTATUS DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3(
IN_CONST_HANDLE hAdapter,
IN_OUT_PDXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 pSetVidPnSourceAddressWithMultiPlaneOverlay
)
{...}
パラメーター
hAdapter
オーバーレイ ハードウェアを含むアダプターを識別します。
pSetVidPnSourceAddressWithMultiPlaneOverlay
表示するサーフェスと表示オプションを記述する DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 構造体へのポインター。
戻り値
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 は次の値を返します。
| リターン コード | 形容 |
|---|---|
| STATUS_SUCCESS | ルーチンは正常に完了しました。 |
| STATUS_INVALID_PARAMETER | [ハードウェア フリップ キュー モデル]/windows-hardware/drivers/display/hardware-flip-queue) で、ドライバーがフリップ要求を処理できませんでした。 |
| STATUS_RETRY | 保留中のフリップが原因で、ドライバーがハードウェア への要求をキューに できなかった、またはドライバーをPASSIVE_LEVELで呼び出す必要があるなどの理由で返されます。 ドライバーをPASSIVE_LEVELで呼び出す必要がある場合は、DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGSも設定する必要があります。PrePresentNeededフラグを します。 |
備考
通常、この関数は割り込みレベルで呼び出されますが、ドライバーがPASSIVE_LEVELでのみ実行できるハードウェア構成を実行する必要がある場合、ドライバーは、STATUS_RETRYを返し、DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGSを設定することによって、PASSIVE_LEVELでこの関数を呼び出すように要求できます。PrePresentNeededフラグを します。
PASSIVE_LEVELで呼び出された場合でも、ドライバーは、呼び出しがメイン GPU スケジューラ スレッドをブロックし、遅延が原因でグリッチが発生する可能性があるため、この呼び出しにかなりの時間を費やすことを避ける必要があります。 時間のかかるアクションは、ドライバーごとに個別の作業項目としてキューに入れ、バックグラウンドで処理する必要があります。 このシナリオでは、キューに置かれた項目と、将来の事前/事後呼び出しによって要求されるハードウェア変更の間の競合は、ドライバーによって管理する必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | d3dkmddi.h |