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，驅動程式應該使用自定義事件資訊標註和檢測命令緩衝區。 否則，驅動程式不應該標註命令緩衝區。

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

傳回值

無

備註

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

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

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

規格需求

另請參閱

D3DWDDM1_3DDI_MARKER_TYPE