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

[アーティクル]
08/07/2023

カーネルモードの表示専用ドライバー (KMDOD) のディスプレイデバイスに画面イメージを表示します。

構文

DXGKDDI_PRESENTDISPLAYONLY DxgkddiPresentdisplayonly;

NTSTATUS DxgkddiPresentdisplayonly(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_PRESENT_DISPLAYONLY pPresentDisplayOnly
)
{...}

パラメーター

hAdapter

ディスプレイアダプターのデバイスコンテキストへのハンドル。 KMDOD の DxgkDdiAddDevice 関数は、以前に MiniportDeviceContext パラメーターでこのハンドルを返しました。

pPresentDisplayOnly

現在の操作に関する情報を含む DXGKARG_PRESENT_DISPLAYONLY 構造体へのポインター。

戻り値

次の値のいずれか。

リターンコード	説明
STATUS_SUCCESS	現在の操作は正常に完了しました。
STATUS_PENDING	現在の操作は、完了するためにソフトウェアまたはハードウェアキューに送信されました。この場合、KMDOD は割り込みおよび遅延プロシージャ呼び出し (DPC) を使用して、現在の操作の進行状況を報告する必要があります。それ以外の場合、オペレーティングシステムはタイムアウト検出と回復 (TDR) プロセスを使用します。これによりエラーが報告され、KMDOD 自体を再初期化して GPU をリセットする必要があります。「備考」で説明されているように、同期モードではこの状態コードを返さないでください。

リターンコード

説明

STATUS_SUCCESS

現在の操作は正常に完了しました。

STATUS_PENDING

現在の操作は、完了するためにソフトウェアまたはハードウェアキューに送信されました。
この場合、KMDOD は割り込みおよび遅延プロシージャ呼び出し (DPC) を使用して、現在の操作の進行状況を報告する必要があります。それ以外の場合、オペレーティングシステムはタイムアウト検出と回復 (TDR) プロセスを使用します。これによりエラーが報告され、KMDOD 自体を再初期化して GPU をリセットする必要があります。
「備考」で説明されているように、同期モードではこの状態コードを返さないでください。

また、ドライバーは、Ntstatus.h で定義されている他のエラー状態コードを返して、現在の操作で発生した問題を示すこともできます。

注釈

KMDOD は、四角形をコピーする前に、画面間のすべての移動ダーティ完了する必要があります。さらに、KMDOD は、別の移動/コピー操作を開始する前に、各移動/コピー操作を完了する必要があります。

オペレーティングシステムでは、KMDOD の現在の操作の 2 つのモード (同期と非同期) がサポートされています。 KMDOD は、ハードウェアとドライバーの実装に応じて、いつでもモードまたは切り替えを使用できます。

オペレーティングシステムでは、「スレッド化と同期のゼロレベル」で定義されているゼロレベルの同期モードにこの関数が従っていることを保証します。

要件

要件	値
サポートされている最小のクライアント	Windows 8
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	デスクトップ
Header	d3dkmddi.h
IRQL	PASSIVE_LEVEL