DXGKDDI_CREATEDEVICE fonction de rappel (d3dkmddi.h)
La fonction DXGKDDI_CREATEDEVICE crée un périphérique de contexte graphique qui est ensuite utilisé dans les appels aux fonctions spécifiques au périphérique du pilote miniport d’affichage.
Syntaxe
DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;
NTSTATUS DxgkddiCreatedevice(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}
Paramètres
hAdapter
[in] Handle vers un bloc de contexte associé à un adaptateur d’affichage. Le pilote miniport d’affichage a précédemment fourni cette poignée pour Dxgkrnl dans le paramètre de sortie MiniportDeviceContext de la fonction DxgiDdiAddDevice.
pCreateDevice
[in/out] Pointeur vers une structure DXGKARG_CREATEDEVICE qui décrit l’appareil de contexte graphique.
Valeur de retour
DXGKDDI_CREATEDEVICE retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | DXGKDDI_CREATEDEVICE correctement créé l’appareil de contexte graphique. |
| STATUS_NO_MEMORY | DXGKDDI_CREATEDEVICE n’a pas pu allouer de mémoire nécessaire pour qu’elle soit terminée. |
Remarques
Dxgkrnl appelle la fonction DXGKDDI_CREATEDEVICE du pilote miniport d’affichage pour créer un périphérique de contexte graphique que le sous-système graphique transmet par la suite aux appels au pilote miniport d’affichage. Le pilote utilise un appareil pour contenir une collection d’états de rendu. Le sous-système graphique peut créer plusieurs appareils dans le même processus sur un adaptateur d’unité de traitement graphique (GPU) donné.
Note
Le nombre d’appareils qui peuvent exister simultanément est limité uniquement par la mémoire système disponible. Autrement dit, un pilote ne peut pas avoir de limite maximale codée en dur.
En règle générale, les appareils sont indépendants les uns des autres ; en d’autres termes, les ressources créées dans un appareil ne peuvent pas être référencées ou accessibles par les ressources créées dans un autre appareil. Toutefois, les ressources interprocesseur sont une exception à cette règle.
DXGKDDI_CREATEDEVICE 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 |