DXGKDDI_CREATECONTEXT fonction de rappel (d3dkmddi.h)

La fonction DxgkDdiCreateContext crée un contexte d’unité de traitement graphique (GPU).

Syntaxe

DXGKDDI_CREATECONTEXT DxgkddiCreatecontext;

NTSTATUS DxgkddiCreatecontext(
  [in]     IN_CONST_HANDLE hDevice,
  [in/out] INOUT_PDXGKARG_CREATECONTEXT pCreateContext
)
{...}

Paramètres

[in] hDevice

Handle pour le périphérique de contexte graphique sur lequel le nouveau contexte est créé. La fonction DxgkDdiCreateDevice du pilote miniport d’affichage fournissait précédemment ce handle au sous-système du noyau graphique Microsoft DirectX dans le membre hDevice de la structure DXGKARG_CREATEDEVICE .

[in/out] pCreateContext

Pointeur vers une structure DXGKARG_CREATECONTEXT qui contient des informations sur la création du contexte.

Valeur retournée

DxgkDdiCreateContext retourne l’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	DxgkDdiCreateContext a correctement créé le contexte.
STATUS_NO_MEMORY	DxgkDdiCreateContext n’a pas pu allouer de mémoire nécessaire pour qu’il se termine.
STATUS_GRAPHICS_DRIVER_MISMATCH	Le pilote miniport d’affichage n’est pas compatible avec le pilote d’affichage en mode utilisateur qui a lancé l’appel à DxgkDdiCreateContext.

Remarques

Un pilote utilise un contexte GPU pour contenir une collection d’état de rendu.

Un seul processus peut créer plusieurs contextes sur un appareil donné.

Le pilote doit prendre en charge un nombre arbitraire de contextes. La seule raison valable pour laquelle un pilote n’a pas pu créer de contexte est si la mémoire système est insuffisante.

En règle générale, chaque contexte peut référencer n’importe quelle ressource créée précédemment pour l’appareil propriétaire de ce contexte.

DxgkDdiCreateContext doit être rendu paginable.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Voir aussi

DXGKARG_CREATECONTEXT

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice