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

Vedi anche

DXGKARG_CREATECONTEXT

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice