DXGKDDI_CREATEDEVICE fonction de rappel (d3dkmddi.h)

  • Article

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 miniport d’affichage a précédemment fourni ce handle à Dxgkrnl dans le paramètre de sortie MiniportDeviceContext de la fonction DXGKDDI_ADD_DEVICE .

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

Voir aussi

DXGKARG_CREATEDEVICE

DXGKDDI_ADD_DEVICE