PFND3DDDI_SETMARKERMODE回呼函式 (d3dumddi.h)

  • 發行項

通知使用者模式顯示驅動程式，它應該支援 Windows (ETW) 標記事件的事件追蹤類型。 選擇性地由 Windows 顯示驅動程式模型實作， (WDDM) 1.3 和更新版本的驅動程式在 Microsoft Direct3D Level 9 硬體上執行。 (請參閱 Direct3D 轉譯效能改善中的需求。) 如需更進階的硬體，驅動程式應該實作 SetMarkerMode 函式。

語法

PFND3DDDI_SETMARKERMODE Pfnd3dddiSetmarkermode;

HRESULT Pfnd3dddiSetmarkermode(
  HANDLE hDevice,
  D3DDDI_MARKERTYPE Type,
  UINT Flags
)
{...}

參數

hDevice

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

Type

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

Flags

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

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

傳回值

如果函式未順利完成，則傳回 S_OK 或適當的錯誤結果。

備註

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

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

規格需求

需求 值
最低支援的用戶端 Windows 8.1，WDDM 1.3 和更新版本
最低支援的伺服器 Windows Server 2012 R2
目標平台 桌面
標頭 d3dumddi.h (包含 D3d10umddi.h)

另請參閱

D3DDDI_MARKERTYPE

SetMarkerMode