DXGKDDI_CREATECONTEXT funzione di callback (d3dkmddi.h)
La funzione DxgkDdiCreateContext crea un contesto di unità di elaborazione grafica (GPU).
Sintassi
DXGKDDI_CREATECONTEXT DxgkddiCreatecontext;
NTSTATUS DxgkddiCreatecontext(
[in] IN_CONST_HANDLE hDevice,
[in/out] INOUT_PDXGKARG_CREATECONTEXT pCreateContext
)
{...}
Parametri
[in] hDevice
Handle per il dispositivo di contesto grafico in cui viene creato il nuovo contesto. La funzione di DxgkDdiCreateDevice del driver miniport di visualizzazione ha fornito in precedenza questo handle al sottosistema kernel della grafica Microsoft DirectX nel hDevice membro della struttura DXGKARG_CREATEDEVICE.
[in/out] pCreateContext
Puntatore a una struttura DXGKARG_CREATECONTEXT che contiene informazioni sulla creazione del contesto.
Valore restituito
DxgkDdiCreateContext restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | DxgkDdiCreateContext ha creato correttamente il contesto. |
| STATUS_NO_MEMORY | DxgkDdiCreateContext non è riuscito ad allocare memoria necessaria per il completamento. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | Il driver miniport di visualizzazione non è compatibile con il driver di visualizzazione in modalità utente che ha avviato la chiamata a DxgkDdiCreateContext. |
Osservazioni
Un driver usa un contesto GPU per contenere una raccolta di stato di rendering.
Un singolo processo può creare più contesti in un determinato dispositivo.
Il driver deve supportare un numero arbitrario di contesti. L'unico motivo valido per cui un driver non è riuscito a creare un contesto è se si esaurisce la memoria di sistema.
In genere, ogni contesto può fare riferimento a qualsiasi risorsa creata in precedenza per il dispositivo proprietario di tale contesto.
dxgkDdiCreateContext deve essere reso impaginabile.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |