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 de 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 de miniport d’affichage a précédemment fourni ce handle à Dxgkrnl dans le paramètre de sortie MiniportDeviceContext de la fonction DxgiDdiAddDevice .
pCreateDevice
[entrée/sortie] Pointeur vers une structure DXGKARG_CREATEDEVICE qui décrit le périphérique de contexte graphique.
Valeur retournée
DXGKDDI_CREATEDEVICE retourne l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
| STATUS_SUCCESS | DXGKDDI_CREATEDEVICE correctement créé le périphérique de contexte graphique. |
| STATUS_NO_MEMORY | DXGKDDI_CREATEDEVICE n’a pas pu allouer la mémoire nécessaire pour qu’elle se termine. |
Remarques
Dxgkrnl appelle la fonction DXGKDDI_CREATEDEVICE du pilote de 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 de miniport d’affichage. Le pilote utilise un périphérique pour contenir une collection d’état de rendu. Le sous-système graphique peut créer plusieurs périphériques dans le même processus sur un adaptateur d’unité de traitement graphique (GPU) donné.
Notes
Le nombre d’appareils pouvant exister simultanément est limité uniquement par la mémoire système disponible. Autrement dit, un pilote ne peut pas avoir une limite maximale de périphériques 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 interprocesseurs sont une exception à cette règle.
DXGKDDI_CREATEDEVICE doivent être paginables.
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 |