PFND3DWDDM1_3DDI_SETMARKERMODE funzione di callback (d3d10umddi.h)

Notifica al driver di visualizzazione in modalità utente che deve supportare un tipo di evento Event Tracing for Windows (ETW). Deve essere implementato da Windows Display Driver Model (WDDM) 1.3 e versioni successive.

Sintassi

PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;

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

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

Type

Valore dell'enumerazione D3DWDDM1_3DDI_MARKER_TYPE che indica il tipo di evento di marcatore che il driver deve supportare.

Flags

Valore UINT che indica se il driver deve fornire informazioni personalizzate nei buffer dei comandi. Se impostato su D3DWDDM1_3DDI_SETMARKERMODE_CUSTOMDRIVEREVENTS, il driver deve annotare e instrumentare i buffer dei comandi con informazioni sull'evento personalizzate. In caso contrario, il driver non deve annotare i buffer dei comandi.

L'annotazione può essere sotto forma di stringa di testo nelle impostazioni locali degli Stati Uniti in inglese o sotto forma di un valore di indice in una posizione in una tabella di stringa. Per quest'ultima opzione, il driver deve anche implementare una funzione che descrive le stringhe indicate dai valori di indice.

Valore restituito

nessuno

Osservazioni

Il driver può usare la funzione di callback pfnSetErrorCb per impostare un codice di errore.

Seguire queste linee guida quando si configurano eventi di marcatore di tipo profilo nel driver in modalità utente, indicato dal tipo di D3DWDDM1_3DDI_MARKER_TYPE_PROFILE :

  • Usare la strumentazione leggera che non produce una forte correlazione con i limiti dei comandi grafici.
  • Il driver deve essere in grado di esempio il timestamp della GPU alla fine della pipeline grafica.
  • Non usare i comandi di campionamento che comportano un carico di prestazioni elevato sulla pipeline grafica, ad esempio comandi wait-for-idle. Per poter instrumentare gli eventi di marcatore del tipo di profilo, il driver non deve scaricare la pipeline o le cache.

Requisiti

Requisito Valore
Client minimo supportato Windows 8.1,WDDM 1.3 e versioni successive
Server minimo supportato Windows Server 2012 R2
Piattaforma di destinazione Desktop
Intestazione d3d10umddi.h (include D3d10umddi.h)

Vedi anche

D3DWDDM1_3DDI_MARKER_TYPE