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 |