Grafici di lavoro

Questo articolo descrive le DDI aggiunte per un driver di grafica in modalità utente (UMD) per supportare grafici di lavoro D3D12. La funzionalità del grafico di lavoro è disponibile a partire da Windows 11 versione 24H2 (WDDM 3.2). Una spiegazione dettagliata dei grafici di lavoro è disponibile nella specifica D3D12 Work Graphs .

Supporto per i grafici di lavoro per la creazione di report

Le interfacce seguenti vengono aggiornate o introdotte per un UMD per segnalare il supporto per i grafici di lavoro:

• La voce di D3D12DDIC piattaforma di strumenti analitici_TYPE_OPTIONS_0109 funzionalità di creazione di report viene aggiunta all'enumerazioneD3D12DDIC piattaforma di strumenti analitici_TYPE usata da PFND3D12DDI_GETC piattaforma di strumenti analitici.

• Questa voce maiuscole corrisponde alla struttura D3D12DDI_OPTIONS_DATA_0103 maiuscole, il cui membro WorkGraphsTier indica il livello di supporto del grafico di lavoro supportato dal driver.

Tabelle delle funzioni DDI

Per supportare i grafici di lavoro, UMD deve implementare le funzioni seguenti e fornire puntatori alle funzioni nelle tabelle delle funzioni DDI seguenti:

• D3D12DDI_DEVICE_FUNCS_CORE_0109:

  • pfnGetProgramIdentifier
  • pfnGetWorkGraphMemoryRequirements

• D3D12DDI_COMMAND_LIST_FUNCS_3D_0108:

  • pfnSetProgram
  • pfnDispatchGraph

Le pagine di riferimento per le decine di strutture e enumerazioni del grafico di lavoro associate a queste DDI aggiunte possono essere individuate seguendo i collegamenti dalle pagine di riferimento DDI.

Strutture ed enumerazioni correlate alla creazione di oggetti di stato DDI

I seguenti D3D12DDI_STATE_SUBOBJECT_TYPE tipi di oggetto secondario (e le relative strutture di creazione di oggetti di stato correlati) sono rilevanti per i grafici di lavoro.

Definizione	Valore enumerazione	Struttura correlata
D3D12DDI_STATE_SUBOBJECT_TYPE_STATE_OBJECT_CONFIG	0	D3D12DDI_STATE_OBJECT_CONFIG_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_GLOBAL_ROOT_SIGNATURE	1	D3D12DDI_GLOBAL_ROOT_SIGNATURE_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_LOCAL_ROOT_SIGNATURE	2	D3D12DDI_LOCAL_ROOT_SIGNATURE_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_NODE_MASK	3	D3D12_NODE_MASK_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_DXIL_LIBRARY	5	D3D12DDI_DXIL_LIBRARY_DESC_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_EXISTING_COLLECTION	6	D3D12DDI_EXISTING_COLLECTION_DESC_0054
D3D12DDI_STATE_SUBOBJECT_TYPE_WORK_GRAPH	13	D3D12DDI_WORK_GRAPH_DESC_0108
D3D12DDI_STATE_SUBOBJECT_TYPE_SHADER_EXPORT_SUMMARY	0x100000	D3D12DDI_FUNCTION_SUMMARY_005

In una definizione di oggetto stato in DDI, i grafici di lavoro sono un sottooggetto di tipo D3D12DDI_STATE_SUBOBJECT_TYPE_WORK_GRAPH. Vedere la struttura D3D12DDI_WORK_GRAPH_DESC_0108 per il layout del sottooggetto. Le strutture e le enumerazioni correlate sono collegate dalla refpage di questa struttura.

Gli altri tipi di oggetto secondario vengono ereditati così com'è dalla specifica DXR.