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 del contesto grafico in cui viene creato il nuovo contesto. La funzione DxgkDdiCreateDevice del driver di visualizzazione ha fornito in precedenza questo handle al sottosistema kernel grafico Microsoft DirectX nel membro hDevice 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 è stato possibile allocare memoria necessaria per il completamento. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | Il driver miniport visualizzato non è compatibile con il driver di visualizzazione in modalità utente che ha avviato la chiamata a DxgkDdiCreateContext. |
Commenti
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 può creare un contesto è se la memoria di sistema viene esaurita.
In genere, ogni contesto può fare riferimento a qualsiasi risorsa creata in precedenza per il dispositivo proprietario di tale contesto.
DxgkDdiCreateContext deve essere reso paginabile.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |