次の方法で共有

DXGKDDI_SYSTEM_DISPLAY_WRITE コールバック関数 (dispmprt.h)

  • [アーティクル]

ディスプレイ デバイスにイメージ ブロックを書き込むディスプレイ ミニポート ドライバーを要求するオペレーティング システムによって呼び出されます。

Windows 8 以降では、オペレーティング システムは、システム停止エラーの後のバグチェック操作中にこの関数を呼び出します。 オペレーティング システムは、ディスプレイ デバイスが DxgkDdiSystemDisplayEnable の呼び出しによって以前にリセット場合にのみ、この関数を呼び出します。

構文

DXGKDDI_SYSTEM_DISPLAY_WRITE DxgkddiSystemDisplayWrite;

void DxgkddiSystemDisplayWrite(
  [in] PVOID MiniportDeviceContext,
  [in] PVOID Source,
  [in] UINT SourceWidth,
  [in] UINT SourceHeight,
  [in] UINT SourceStride,
  [in] UINT PositionX,
  [in] UINT PositionY
)
{...}

パラメーター

[in] MiniportDeviceContext

ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiAddDevice 関数は、以前に Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。

[in] Source

システム停止エラーに関する情報を表示するバグチェック画面に書き込まれるソース イメージの開始アドレスへのポインター。

[in] SourceWidth

指定したソース イメージの幅をピクセル単位で指定する UINT 値。

[in] SourceHeight

指定したソース イメージの高さをピクセル単位で指定する UINT 値。

[in] SourceStride

指定したソース イメージの各行のバイト数を指定する UINT 値。

[in] PositionX

指定したソース イメージをディスプレイ デバイスに書き込む開始 X 座標を指定する UINT 値。

[in] PositionY

指定したソース イメージをディスプレイ デバイスに書き込む開始 Y 座標を指定する UINT 値。

戻り値

何一つ

備考

ソース イメージの制限

ディスプレイ ミニポート ドライバーは、その DxgkDdiSystemDisplayWrite 関数が呼び出されたときに、次のガイドラインに従う必要があります。
  • ソース イメージの色形式は、常に D3DDDIFMT_R8G8B8 (ピクセルあたり 24 ビット) または D3DDDIFMT_A8R8G8B8 (32 bpp) 形式の D3DDDIFORMAT 列挙体にあります。 ディスプレイ ミニポート ドライバーは、DxgkDdiSystemDisplayEnable が呼び出されたときに、この形式で書き込み操作を有効にする表示モードを以前に設定していました。
  • ソース イメージが非ページ メモリ内にあります。 ディスプレイ ミニポート ドライバーは、PostionX および PositionY パラメーターで指定された位置から現在のフレーム バッファーにこのソース イメージを書き込む必要があります。
  • ディスプレイ ミニポート ドライバーは、フレーム バッファーにイメージ ブロックを書き込むには、CPU を使用する必要があります。 システムで停止エラーが発生した場合は、ディスプレイ デバイスでの継続的なタイムアウト検出と回復 (TDR) が原因である可能性があります。 その場合、グラフィックス処理装置 (GPU) が不明な状態になっている可能性があります。

    TDR の詳細については、「タイムアウトの検出と回復 (TDR)」を参照してください。

ページ以外のメモリを使用する

この関数が呼び出されている間は、Windows カーネル モード関数を使用できない場合があります。

DxgkDdiSystemDisplayWrite は任意の IRQL で呼び出すことができるので、非ページ メモリ内に存在する必要があります。 DxgkDdiSystemDisplayWrite 、ページング可能メモリ内のコードを呼び出す必要はありません。また、ページング可能メモリ内のデータを操作してはなりません。

必要条件

要件 価値
サポートされる最小クライアント Windows 8
サポートされる最小サーバー Windows Server 2012
ターゲット プラットフォーム の デスクトップ
ヘッダー dispmprt.h
IRQL 任意のレベル (「解説」セクションを参照)

関連項目

DxgkCbAcquirePostDisplayOwnership を する

DxgkDdiAddDevice の

DxgkDdiStopDeviceAndReleasePostDisplayOwnership

DxgkDdiSystemDisplayEnable の