PFND3DDDI_SETMARKERMODE funzione di callback (d3dumddi.h)

  • Articolo

Notifica al driver di visualizzazione in modalità utente che deve supportare un tipo di evento marcatore ETW (Event Tracing for Windows). Facoltativamente implementata dai driver Windows Display Driver Model (WDDM) 1.3 e versioni successive in esecuzione su hardware Microsoft Direct3D Level 9. Vedere i requisiti nei miglioramenti delle prestazioni del rendering Direct3D. Per hardware più avanzato, i driver devono implementare la funzione SetMarkerMode .

Sintassi

PFND3DDDI_SETMARKERMODE Pfnd3dddiSetmarkermode;

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

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

Type

Valore dell'enumerazione D3DDDI_MARKERTYPE che indica il tipo di evento 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 D3DDDI_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 Inglese-Stati Uniti o sotto forma di valore di indice in una posizione in una tabella di stringhe. Per quest'ultima opzione, il driver deve implementare anche una funzione che descrive le stringhe indicate dai valori di indice.

Valore restituito

Restituisce S_OK o un risultato di errore appropriato se la funzione non viene completata correttamente.

Commenti

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

  1. Usare la strumentazione leggera che non produce una forte correlazione con i limiti dei comandi grafici.
  2. Il driver deve essere in grado di campionare il timestamp della GPU alla fine della pipeline grafica.
  3. Non usare i comandi di campionamento che comportano un carico di prestazioni elevato sulla pipeline grafica, ad esempio i comandi wait-for-idle. Per poter instrumentare gli eventi marcatori di tipo 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 d3dumddi.h (include D3d10umddi.h)

Vedi anche

D3DDDI_MARKERTYPE

SetMarkerMode