PFND3DDDI_CREATEDEVICE fonction de rappel (d3dumddi.h)
La fonction CreateDevice crée un contexte graphique référencé dans les appels suivants.
Syntaxe
PFND3DDDI_CREATEDEVICE Pfnd3dddiCreatedevice;
HRESULT Pfnd3dddiCreatedevice(
HANDLE hAdapter,
D3DDDIARG_CREATEDEVICE *unnamedParam2
)
{...}
Paramètres
hAdapter
Handle qui identifie la carte graphique.
unnamedParam2
pCreateData [in, out]
Pointeur vers une structure D3DDDIARG_CREATEDEVICE . En entrée, cette structure contient des informations que le pilote peut utiliser. Lors de la sortie, le pilote spécifie des informations dans la structure que le runtime Microsoft Direct3D peut utiliser.
Valeur retournée
CreateDevice retourne l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
| S_OK | Le contexte graphique est créé avec succès. |
| E_OUTOFMEMORY | CreateDevice n’a pas pu allouer la mémoire nécessaire pour qu’il se termine. |
Remarques
Un périphérique d’affichage est un contexte graphique utilisé pour contenir une collection d’état de rendu. Plusieurs appareils peuvent être créés par le même processus sur un adaptateur donné. Notez que le nombre de périphériques d’affichage pouvant exister simultanément est limité uniquement par la mémoire système disponible. Autrement dit, un pilote ne peut pas coder en dur une limite maximale de périphériques.
En règle générale, les appareils étant indépendants les uns des autres, 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. Toutefois, les ressources interprocesseurs sont une exception à cette règle.
Lorsque le runtime Direct3D appelle CreateDevice pour créer un appareil, le runtime ne crée pas de thread de contexte d’unité de traitement graphique (GPU) par défaut pour l’appareil. Le pilote doit appeler explicitement la fonction pfnCreateContextCb pour créer un ou plusieurs contextes en fonction des besoins.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | d3dumddi.h (inclure D3dumddi.h) |