PFND3DDDI_SETMARKERMODE funzione di callback (d3dumddi.h)

Articolo
02/06/2025

Notifica al driver di visualizzazione in modalità utente che deve supportare un tipo di evento ETW (Event Tracing for Windows). Facoltativamente implementati dai driver Windows Display Driver Model (WDDM) 1.3 e versioni successive in esecuzione nell'hardware Microsoft Direct3D Level 9. Vedere i requisiti in miglioramenti delle prestazioni di rendering Direct3D. Per un 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 English-US oppure 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.

Osservazioni

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

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

Fabbisogno

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)

Vedere anche

D3DDDI_MARKERTYPE

SetMarkerMode

Condividi tramite