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 vers l’appareil de contexte graphique sur lequel le nouveau contexte est créé. La fonction DxgkDdiCreateDevice du pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique Microsoft DirectX dans le hDevice membre 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 de retour
DxgkDdiCreateContext retourne l’une des valeurs suivantes :
| Retourner le code | 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’elle 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’états de rendu.
Un processus unique peut créer plusieurs contextes sur un appareil donné.
Le pilote doit prendre en charge un nombre arbitraire de contextes. La seule raison valide 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Bureau |
| d’en-tête | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |