PFND3DDDI_SETMARKER funzione di callback (d3dumddi.h)

Articolo
02/25/2024

Notifica al driver di visualizzazione in modalità utente che deve generare un nuovo timestamp se un lavoro GPU è stato completato dall'ultima chiamata a pfnSetMarker. 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 SetMarker .

Sintassi

PFND3DDDI_SETMARKER Pfnd3dddiSetmarker;

HRESULT Pfnd3dddiSetmarker(
  HANDLE hDevice
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

Valore restituito

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

Commenti

Se il tipo di evento marcatore del parametro Type della funzione pfnSetMarkerMode non è D3DDDIMT_NONE, il driver di visualizzazione in modalità utente deve eseguire questa procedura con ogni chiamata a pfnSetMarker:

Incrementare il valore del membro APISequenceNumber della struttura D3DDDICB_LOGUMDMARKER .
Determinare i contesti associati alle chiamate di rendering DDI (Device Driver Interface) a thread singolo inviate con l'ultima chiamata a pfnSetMarker. Per ogni contesto di questo tipo:
1. Se il buffer dei comandi per il contesto è vuoto, non eseguire alcuna operazione.
2. In caso contrario:
  - Assicurarsi che nel buffer della cronologia del contesto sia disponibile più memoria. Se necessario, scaricare il buffer.
  - Aggiungere un'altra voce al buffer del numero di sequenza API del contesto che contiene i 32 bit bassi del valore APISequenceNumber corrente.
  - Timestamp di esempio e scrittura appropriati per il tipo di evento marcatore corrente.
3. Aggiornare i dati di rilevamento che verranno usati alla successiva chiamata di pfnSetMarker .

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

SetMarker

pfnSetMarkerMode

Condividi tramite