DXGKDDI_SYSTEM_DISPLAY_WRITE回呼函式 (dispmprt.h)

發行項
02/23/2024

由操作系統呼叫，要求顯示迷你埠驅動程式將影像區塊寫入顯示裝置。

從 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	任何層級 (請參閱一節)