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
UINT 值，指定指定的來源影像應在顯示裝置上寫入的起始 X 座標。
[in] PositionY
UINT 值，指定指定的來源影像應在顯示裝置上寫入的起始 Y 座標。
傳回值
沒有
言論
來源影像限制
呼叫 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