共用方式為


PFND3DWDDM1_3DDI_SETMARKERMODE回呼函式 (d3d10umddi.h)

通知使用者模式顯示驅動程式,它應該支援 Windows 事件追蹤類型 (ETW) 標記事件。 Windows 顯示驅動程式模型 (WDDM) 1.3 和更新版本的驅動程式必須實作。

語法

PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;

void Pfnd3dwddm13DdiSetmarkermode(
  D3D10DDI_HDEVICE hDevice,
  D3DWDDM1_3DDI_MARKER_TYPE Type,
  UINT Flags
)
{...}

參數

hDevice

顯示裝置的句柄(圖形內容)。

Type

來自 D3DWDDM1_3DDI_MARKER_TYPE 列舉的值,指出驅動程式應該支援的標記事件類型。

Flags

UINT 值,指出驅動程式是否應該在命令緩衝區中提供自定義資訊。 如果設定為 D3DWDDM1_3DDI_SETMARKERMODE_CUSTOMDRIVEREVENTS,驅動程式應該使用自定義事件資訊來標註和檢測命令緩衝區。 否則,驅動程式不應該標註命令緩衝區。

批註可以是 English-US 地區設定中的文字字串形式,或以索引值的形式呈現在字串數據表中的位置。 針對後者選項,驅動程式也必須實作函式,以描述索引值所指出的字串。

傳回值

沒有

言論

驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。

當您在使用者模式驅動程式中設定設定檔類型標記事件時,請遵循下列指導方針,D3DWDDM1_3DDI_MARKER_TYPE_PROFILE 類型:

  • 使用輕量型檢測,其不會產生與圖形命令界限的強關聯。
  • 驅動程式必須能夠在圖形管線結尾取樣 GPU 時間戳。
  • 請勿使用對圖形管線造成高效能負擔的取樣命令,例如等候閑置命令。 若要能夠檢測配置檔類型的標記事件,您的驅動程式不應該需要排清管線或快取。

要求

要求 價值
最低支援的用戶端 Windows 8.1、WDDM 1.3 及更新版本
支援的最低伺服器 Windows Server 2012 R2
目標平臺 桌面
標頭 d3d10umddi.h (包括 D3d10umddi.h)

另請參閱

D3DWDDM1_3DDI_MARKER_TYPE